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PREFACE 


The KRONOS Time-Sharing System was developed by the Business and Industrial Systems 
Division of Control Data Corporation. KRONOS processes jobs from a maximum of 384 
time-sharing terminals, central site batch jobs, and remote batch jobs. 

This manual describes the external features of the KRONOS Operating System for the batch 
user. It does not contain a detailed internal description of the associated software nor a 
description of the time-sharing commands. 

For further information concerning Control Data® 6000 Series computers and the KRONOS 
Time-Sharing System, consult the following manuals: 


Title Publication Number 

Control Data 6400/6500/6600 60100000 

Computer Systems 
Reference Manual 

Time-Sharing FORTRAN 59150900 

Reference Manual 


FORTRAN Translator (FTNTRAN) 59151000 

Reference Manual 


EXPORT/IMPORT 
Reference Manual 

BASIC 

Reference Manual 
ALGOL 

Reference Manual 

Text Editor (EDIT) 
Reference Manual 

KRONOS Operating Guide 

Control Data MODIFY 
File Editing System 
Reference Manual 

Instant KRONOS 

Time-Sharing User’s 
Reference Manual 

KRONOS Terminal User’s 
Instant Manual 


59150500 

59150800 

59151200 

59150700 

59151600 

59151100 

59152100 

59151300 

59152000 


iii 
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SYSTEM DESCRIPTION 


1 


INTRODUCTION 

The KRONOS Time-Sharing System coordinates multiple-user access to one CDC 6000 
Series computer. Programs can be submitted from: 

• Time-Sharing Terminal 

• Central Site 

• 200 User Terminal 

The user can submit his job to KRONOS from a time-sharing terminal. The terminal re¬ 
sponds as if it were a small computer console to which the user has sole access. However, 
the 6000 Series computer at the central site allocates only a small portion of its total time 
to process the requests of each individual terminal in succession. Hence, KRONOS is a 
time-sharing system. 

A user can also enter his program at the computer center. He can then use all the equip¬ 
ment attached to the computer; i, e., card reader, punches, line printers, tapes, and other 
peripheral devices. 

The user can also communicate with the 6000 Series computer from a 200 User Terminal 
at his own site. One or more jobs are collected into a job stack which is sent to the com¬ 
puter center over telephone lines. KRONOS processes the job stack in a manner similar 
to that of local batch processing. The system transmits the resulting output to the remote 
site. 

KRONOS operation and performance depend directly on the system resources available for 
job processing. The job types, the number of time-sharing users, and the remote batch 
terminals determine the minimum hardware configuration necessary for system operation. 

HARDWARE/SOFTWARE INTEGRATION 

KRONOS uses the ten Peripheral Processor Units (PPUs) for system and input/output tasks, 
and the Central Processor Unit (CPU) to execute the user's jobs. Central Memory (CM) con¬ 
tains the user programs and a system software area called Central Memory Resident (CMR). 
When the term "system" appears in this manual, it is the equivalent of the KRONOS operat¬ 
ing system. When lower case letters appear in format descriptions, they represent user- 
supplied values. Capital letters and punctuation markst represent themselves, 
f The exception is the ellipsis (...) 
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CENTRAL PROCESSOR UNIT 


The CPU performs computational tasks but has no input/output capability. It communicates 
with the outside world through central memory. Under KRONOS, the CPU is used almost ex¬ 
clusively for program compilations, assemblies, and executions. The CPU program makes 
request of the system through the CPU Request register which is the Reference Address 
plus one (RA+1) of the current program. 

PERIPHERAL PROCESSOR UNITS 

The ten peripheral processors (PPO, PPl, . . . , PP9) are identical and perform a variety 
of tasks. However, the PPUs cannot assemble, compile, and execute user programs effi¬ 
ciently. Under KRONOS, the PPus are assigned various tasks such as system housekeep¬ 
ing, job processing, and input/output. 

PPU number 0 contains the Monitor Program (MTR) that oversees or controls all other 
system activities. PP9, under the supervision of MTR, permanently drives the console 
typewriter and display scopes. The remaining PPUs, 1 through 8, are initially assigned 
to read their input registers (specific locations in central memory) over and over. To 
make a request, the monitor inserts a significant word into the input register of a PPU. 

When the PPU reads its input register, it obeys the request (or determines that it cannot 
do so), sets a drop PPU request in its output register to indicate to the monitor that the 
PPU has processed the request, and returns to its idling state. When idling, pool PPUs 
continually read their input registers. Thus, all requests to a PPU (other than PPO) are 
communicated through the input register of that PPU. 

Each PPU (other than PPO) uses its output register (another location in central memory) 
for requests to the monitor and for completion status of the requests. The monitor peri¬ 
odically searches the PPU output registers for requests. The monitor zeros certain bits 
in the PPU output registers when the requests have been processed. 

Although the primary task of a PPU is to act on requests from MTR, a PPU most occasion¬ 
ally request the cooperation of another PPU. PPUs request these additional PPUs through 
the monitor and must request permission from the monitor before using an input/output 
channel. Since each PPU is capable of connecting itself to any channel, only one PPU can 
use a specific channel at one time. To avoid two PPUs attempting to use the same channel 
(which would hang up both PPUs and the channel), the monitor maintains a list of channels 
and their status. Whenever a PPU requires a channel, it must first request the monitor to 
assign that channel for its exclusive use. When finished with the channel, the PPU specifies 
to the monitor that the channel is free. 
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CENTRAL MEMORY (60-BIT WORDS) 


A number of programs can be executed concurrently under KRONOS. These programs are 
stored in central memory (user area) along with a set of necessary data for system opera¬ 
tion (central memory resident). Central memory is accessible to both the CPU (within the 
field length of a given program) and the PPUs, and thus forms the communications link be¬ 
tween the 11 processors and the system. 

Central memory resident contains the library directory, system communication area, sys¬ 
tem tables, the CPU resident routine, and information about each job currently being exe¬ 
cuted. The user area contains the programs currently being executed for each job. 

Central memory words are 60 bits in length and contain five 12-bit PPU memory words. 
These five PPU words, called bytes, are numbered 0 through 4: 


59 


47 

35 

23 

11 0 

byte 0 

byte 1 

byte 2 

byte 3 

byte 4 


Central Memory Word 


MULTIPROGRAMMING 

CONTROL POINTS 

The system can execute several jobs simultaneously. During execution, these jobs are 
numbered (1-n). The index of each job is called a control point. When the system has se¬ 
lected a job for execution, it assigns the job to a control point. The control point number 
identifies and differentiates the job from the other jobs in execution. Each control point,has 
a control point area in central memory that contains all of the information necessary for 
KRONOS to define and process the assigned job. 

CONTROL POINT AREA 

When a job is in central memory, the control point area to which it is assigned contains 
such information as job name, length, starting address in CM, elapsed time, assigned I/O 
equipment, and control statements. The control point area also contains a 16-word section 
called the exchange package. The exchange package contains all necessary information for 
starting or resuming a CM program — the contents of all registers used in executing a pro¬ 
gram. 

Under KRONOS, control point 1 is dedicated to TELEX, the CPU executive for the REMOTE 
teletypewriter communication package. Control point n is reserved for the EXPORT/IM¬ 
PORT executive. 
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CONTROL POINT NUMBER 


In the control point system, a 5-bit number identifies a job in process. For example, a 
user's program requests the system to read a magnetic tape. This request generates 
several internal requests (which the PPUs pass back and forth). Each of these requests 
requires only five bits to identify the user's job. 


FILES 

A file is an organized collection of data. The file name identifies it to the user and to the 
system. KRONOS, the jobs it processes, and intermediate results are files or parts of 
files. A file consists of one or more logical records. Each logical record contains one 
or more Physical Record Units (PRUs) of data. 

Files can be transferred from one device to another since equivalent formats are used for 
files on cards, printer, disk, and magnetic tape. The information in a file is stored seri¬ 
ally. An object program can operate on named files and the actual medium of a file can 
be specified on control cards; disk storage is assumed if no medium is specified. 

Coded information is stored internally in display code on either a disk sector or a mag¬ 
netic tape record. The concept of logical records makes it possible to have equivalent 
forms of a file on several media, without losing the advantages of each form of storage. 
For example, several cards constituting a logical record can be transferred to an equi¬ 
valent form on disk storage where they are blocked in sectors. 


FILE NAMES 

File names consist of one to seven alphanumeric characters. 

Input and output operations of a central program involve a named file — a disk, magnetic 
tape, punched card, or printer file. The physical unit associated with a file name is con¬ 
trolled by the job control cards and is not a function of the central program coding directly. 
The operating system provides a common interface between the central program and the 
peripheral programs which drive the equipment. 

The special files named: 

• INPUT 

• OUTPUT 

• PUNCH 

• PUNCHB 

• P8 
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are supplied to each job by the system. The user should not try to assign these names to 
other temporary or I/O files. 


INPUT FILE 

The file named INPUT is the file from which the job can be read after it has been assigned 
to a control point. Before a job is at a control point, the job file is identified by the job name. 

OUTPUT FILE 

The file named OUTPUT contains the results which are to become printed copy when the job 
terminates. During job processing, the file OUTPUT collects records which are to be 
printed. When job processing is completed, the name of this file changes from OUTPUT to 
the job name. 

PUNCH FILE 

The file named PUNCH contains the data which is to become Hollerith punch card output 
when the job terminates. When job processing is completed, the name of this file changes 
from PUNCH to the job name. 

PUNCHB FILE 

The file named PUNCHB contains the data which is to become binary punch card output when 
the job terminates. When job processing is completed, the name of file PUNCHB also 
changes to the job name. 

P8 FILE 

The file named P8 contains the data which is to become 80-column binary punch card output 
when the job terminates. When job processing is completed, the name of file P8 also 
changes to the job name. 

LOGICAL RECORDS 

All files under the KRONOS system are organized into logical records. Input files are organ¬ 
ized into logical records by the language translator or other program producing the output. 
Otherwise, the user must generate logical records. 

Since the logical record is defined for each type of peripheral device, files retain their 
structure when transferred between devices. The physical format of a logical record is 
determined by the device on which the file resides. The physical record unit size is the 
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smallest amount of information the system transfers during a single physical read or write 
operation for each device. 

Logical records consist of one or more PRUs, the last of which is short- or zero-length. 
For mass storage and tape, a physical record unit that contains less than the normal amount 
of data marks the End-of-Record (EOR). Card data has a special EOR mark. An EOR is 
written on tape or mass storage as a zero-length PRU if the logical record data is an even 
multiple of the PRU size, or if a write operation was requested when no data was in the 
buffer. A zero-length PRU is a PRU containing no data. 

DATA FORMATS 

Data within the system can be binary or coded. Binary records can be of any length. Coded 
records are lines of display-coded characters. Binary data is in images of central memory 
but is blocked into physical records. The data block lengths are device-dependent. 

Each line of coded data begins at the first byte of a word and continues two characters per 
byte to the end of a line. The line can be of any length, but should be of a size correspond¬ 
ing to the device to which the line will be written. The last CM word of the line is completed 
with at least one cleared byte. A cleared byte is the End-of-Line designation. 

Coded data on mass storage or odd parity tape has the same format as binary data, and can 
be grouped into records. The following paragraphs describe data formats for each device. 

MASS STORAGE 

All data on a mass storage device is in 64 CM word PRUs. Each PRU is preceded by two 
bytes of control information which is available to the system only. Files on mass storage 
can be randomly accessed (logical records of mass storage can be read or written directly 
without reading or writing the entire file). Under KRONOS, a user can access a random file 
record by address or by record index. In Address mode, a user can access any random 
access file. In Index mode, a user can access only those random access files which have a 
list of record names or numbers as the first logical record. The addressing structure 
allows random access files to be temporarily stored on non-random devices without losing 
their random access characteristics. 

After an initial random access read request for a file or End-of-Information has been writ¬ 
ten, the system treats a random access file like a sequential file. Subsequent read or write 
requests occur at the current file position. 

The RPHR and WPHR macros can be used to randomly read or write a PRU of data. 
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KRONOS allows a random access file to be used as a sequential file. However, a user should 
not assume that a rewritten random access file is in any particular order, 

ADDRESS MODE 

The Address mode of random access allows the user to read or rewrite any group of PRUs. 
The user specifies the address of the first PRU to be read or rewritten. The length of the 
buffer or data in the buffer determines the number of PRUs to be read or rewritten. There¬ 
fore, the rewrite feature should be used carefully because it is possible to overwrite into 
the next block of data if a user requests a random write when more data is in the buffer than 
in the original block. Also, End-of-File (EOF) and End-of-Record write requests can cause 
control PRUs to overlap into following data. 

To request Address mode random access processing, set the random access bit (r), set the 
first sector number in the random request field of the File Environment Table (FET) (Sec¬ 
tion 4), and set bit 17 of the random request field. 


INDEX MODE 

The Index mode of random access requires a table of record names or numbers with the 
associated first sector numbers. When an indexed random access file is to be saved, the 
system writes this table as the last logical record of the file. 

A table of record names requires two words per record. A table of record number requires 
one word per record. 

All random write requests on an indexed file occur at the End-of-Information mark. There¬ 
fore, when a record on an indexed file is rewritten, it can differ in size from the original 
record. The system writes the new record at the End-of-Information (EOI) mark and does 
not release the space reserved for the old record. 

KRONOS provides system macros for Index mode random access (Section 4). 

CODED PUNCHED CARDS 

Coded cards are in Hollerith code, 80 characters per card. The system reads data 
from cards, converts it to display code, deletes trailing spaces, and packs it into a line of 
up to nine CM words. The system punches data for a card until an End-of-Line mark or the 
80th character appears. If an End-of-Line mark does not appear after 80 characters, data 
is lost. Since the search for an End-of-Line mark terminates when 14 CM words have been 
checked, a maximum of 60 characters can be lost if this condition occurs. 
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CONVERSION 


Conversion can be specified by the code card. This card has a 5-7-9 punch in column 1. 
Column 2 specifies the conversion. 


Column 2 
blank 
9 
8 


Conversion 

026 

029 FORTRAN 
029 COBOL 


Conversion is initially set to 026. A conversion code remains in effect until changed or 
until an End-of-Information mark is read, whichever occurs first. 


BINARY PUNCHED CARDS 

Binary cards contain: 

• up to 15 words per card, 

• a 7-9 punch in column 1, 

• word count of card in column 1, rows 0, 1, 2, 3, 

• an ignore checksum punch in column 1, row 4, 

• the checksum modulo 4,095 in column 2, 

• the binary sequence number in columns 79 and 80, and 

• a blank in column 78. 

An End-of Record mark has a 7-8-9 punch in column 1. An End-of-File mark has a 6-7-9 
punch in column 1. An End-of-Information mark has a 6-7-8-9 punch in column 1. 


PRINTED DATA 

All printed data is in coded format. The system extracts data to be printed until an End-of- 
Line mark or the 136th character appears. If an End-of-Line mark does not appear after 
136 characters, data is lost. Since the search for an End-of-Line mark terminates when 
14 CM words have been checked, up to four characters can be lost. 

CARRIAGE CONTROL 

The system recognizes the first character in a line as the carriage control character. If the 
first character is a carriage control character (Table 1-1), it is not printed. When the 
system recognizes a carriage control character, it prints a line containing a maximum of 
135 characters. Print mode is normally Auto Eject mode (single-space and bypass paper 
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crease). This is the only carriage control command that remains in effect until changed. 
All other carriage control commands must be given for each line that they control. 


TABLE 1-1. CARRIAGE CONTROL CHARACTERS 


Character 

Command 

space 

Single-space 

1 

Eject page before print 

0 

Skip one line before print (double space) 

- 

Skip two lines before print (triple space) 

+ 

Suppress space before print 

/ 

Suppress space after print 

2 

Skip to last line of form before print t 

8 

Skip to format channel 1 before print 

7 

Skip to format channel 2 before print t 

6 

Skip to format channel 3 before print t 

5 

Skip to format channel 4 before print! 

4 

Skip to format channel 5 before print! 

3 

Skip to format channel 6 before print! 

H 

Skip to format channel 1 after print 

G 

Skip to format channel 2 after print 

F 

Skip to format channel 3 after print 

E 

Skip to format channel 4 after print 

D 

Skip to format channel 5 after print 

C 

Skip to format channel 6 after print 

Q 

Clear Auto Eject 

R 

Set Auto Eject 

S 

Select 6 lines 

T 

Select 8 lines 


fNo space after print 


STANDARD FORMAT MAGNETIC TAPE 

The standard KRONOS magnetic tape format is 7-track, 1/2-inch tape. The system writes 
to tape in odd parity; 512 CM word PRUs. An EOR mark is a short PRU (less than 512 
words) and an EOF mark is a tape file mark. Data is in central memory image. 
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UNBLOCKED EXTERNAL BCD FORMAT MAGNETIC TAPE 

Unblocked External BCD format is 7-track, line or card image 1/2-inch tape. The system 
writes to tape in even parity, 136 character PRUs unless the user specifies another PRU 
size on an ASSIGN or REQUEST card. Both EOR and EOF marks are represented by tape 
file marks. The system converts data to display code, deletes trailing spaces, and stores 
ten characters per CM word for a read operation. For a write operation, the system con¬ 
verts data to External BCD, adds trailing spaces if necessary, and writes the characters in 
a coded line, discarding characters that occur after the specified number. 


BLOCKED EXTERNAL BCD FORMAT MAGNETIC TAPE 

Blocked External BCD format is 7-track, 1/2-inch tape. The system writes to tape in even 
parity, 150 character PRUs unless the user specifies another PRU size on an ASSIGN or 
REQUEST card. Both EOR and EOF marks are represented by tape file marks. The sys¬ 
tem converts data to display code and stores ten characters per CM word for a read opera¬ 
tion. If necessary, the system completes the last word with spaces. For a write operation, 
the system converts data to External BCD and writes the characters in a coded line, dis¬ 
carding the characters that occur after the specified number. 

PERMANENT FILES 

Under KRONOS the user has access to permanent files — files which cannot be lost by a dead- 
start operation. Permanent files can be accessed in any available system mode (Address 
or Index) once the file has been retrieved from permanent file storage and is available at 
the user’s control point. 
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JOB PROCESSING 


2 


A job consists of one file of punched cards or card images. The first logical record of a job 
file contains the control cards that specify the job's processing requirements. The system 
processes jobs in three sequential but independent stages: 

• Input 

• Execution 

• Output 

Many jobs can be in the input and output stages of processing but only n jobs (one for each 
control point) can be in the execution stage. Each job must begin with a job card and end 
with an End-of-Information card. All other control cards follow the job card directly. The 
end of the control cards is signified by a 7-8-9 card (End-of-Record) or a 6-7-8-9 card 
(End-of-Information) if the job consists of control cards only. 

JOB INPUT 

The system reads an entire job from the card reader and stores it on mass storage in the 
input queue. A typical job file has three logical records: control cards, program cards, 
and data cards. 


JOB EXECUTION 

The system executes a job by: 

• bringing the job to a control point, 

• following the directives of the control cards, and 

• accumulating data for the output stage of job processing. 

A job is executed only when it is assigned to a control point. One job is assigned to each 
control point. When a control point becomes available, the system selects a job from the 
input queue and assigns it to the free control point. 

After a job is assigned to a control point, KRONOS advances the job according to the job control 
cards. These control cards contain directives (such as LOAD or EXECUTE) that are inter¬ 
preted and obeyed, one at a time, in the order they appear in the job file. For example, a 
compilation is achieved by a load and execute of the desired compiler program. 
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During execution, the system accumulates the output data (if there is any) in files on the 
system mass storage device. 

JOB OUTPUT 

When the system has obeyed the last control card for a job, it enters the files of accumulated 
output data into the output queue. The system selects files from the output queue and pro¬ 
cesses them according to file type (punched cards, printer listings, etc. ). 

CONTROL CARD TRANSLATION 

KRONOS translates a control statement by: 

1. Reading the statement from the control point control card buffer. If necessary, the 
system reloads control statements from the file INPUT. 

2. Deleting all spaces between the beginning of the statement and the termination char¬ 
acter (a period or a right parenthesis). KRONOS allows only standard FORTRAN 
characters to appear before the termination character, although other characters 
can appear in the comment field. 

3. Searching the list of control card names and comparing them with the name of the 
card being processed. If the card name is on the list, the system processes the 
control statement according to the parameters. If the card name is not on the list, 
the system searches further. 

4. Searching the File Name Table with the first characters (seven or less up to the 
separator character) for a file assigned to the control point with a name identical 
to the first characters of the control statement. If the system finds such a file on 
a mass storage device in absolute format, the system reads the file into central 
memory as a CPU program. If the file resides on anon-mass storage device, KRONOS 
aborts the job. If the file is in relocatable format on a mass storage device, the 
system transfers control to the loader (Section 5), extracts the arguments from the 
control statement, stores them in RA+2 through RA+(n+l), and requests the CPU 
to begin program execution. 

5. Searching the Chippewa Library Directory for a program name that coincides with 
the card name. If the system finds such a program, it loads the program, stores 
the arguments in RA+2 through RA+(n+l), and requests the CPU to begin program 
execution. 
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6. Searching the SCOPE Library Directory for a program name that coincides with 
the card name. If the system finds such a program in absolute format, the system 
proceeds as for a Chippewa Library program (Step 5). If the program is in relocat¬ 
able format, the system transfers control to the loader (Section 5). 

7. Searching the Peripheral Library Directory if the statement name is three charac¬ 
ters long and begins with a letter. If the system finds such a program, it constructs 
a call to a PPU using the name and arguments from the control statement. 

If KRONOS cannot process the control statement during these steps, it declares the control 
statement illegal, issues a dayfile message, and aborts the control point job. 
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CONTROL CARDS 


3 


As introduced in Section 2, control cards direct job execution. KRONOS recognizes four 
types of control cards: 

• Job 

• Program Execution 

• File Management 

• Permanent File 

All control cards, except the job card and program call cards, have two fields. The first 
field contains the card name, beginning in column 1. Card names described in this section 
are reserved for the system and cannot be used as program call names. The second field 
is optional; it can contain one or more parameters separated by commas. The two fields 
are separated by a separator character: +-’’/ = , ( or $. 

The parameter field is terminated by a period or right parenthesis. A terminator must be 
present, even though no parameters are specified. 

The card names on job cards and program call cards contain the name of the job and the 
name of the program, respectively. 

JOB CONTROL CARDS 

JOB CARD 

Control card format: jobname, Tt, CMfl, Pp. or 

jobname, p, t, fl. 

jobname Alphanumeric job name (one to seven characters) must begin with a 

letter. To assure unique job names, KRONOS replaces the last three 
characters with a system-generated value. 

t Central processor time limit in octal seconds (maximum 77770g). 

This time limit must suffice for compilation and execution of the job. 

If t is absent, KRONOS assumes t=100g (lOOg seconds 1 minute). 

fl Total central memory field length of the job; a maximum of six octal 

digits. The system rounds the field length (storage requirement) to 
a multiple of lOOg. This field length cannot exceed: 
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• 360,0000 on a 131K machine 

• 163,0000 on a 65K machine 

• 61,0008 on a 32K machine 

If fl is absent, KRONOS assumes fl=50, OOO^. 

o 

p Priority level (octal) at which job enters the system; 

1 < p < 17. If p is absent, KRONOS assumes p-10. 

The first control card for a job indicates the job name, priority, CPU time limit, and 
memory requirements. Commas separate the fields and a period terminates the job card. 
Blanks have no meaning. Fields other than jobname can appear in any order when identified 
by the leading characters in the field. 

ACCOUNT CARD 

Control card format: ACCOUNT, xxxxxxx, pswd. 

xxxxxxx user account number 

pswd user password 

The second card in the control card record must be the ACCOUNT card. It specifies the 
user’s account number. This account number is used in system bookkeeping as well as for 
user access to permanent files. 


ONSW CARD 

Control card format: ONSW (n^, n^, . . n^) 

n. Pseudo-sense switch number; 1 < n < 6. 

The ONSW control card sets pseudo-sense switches for reference by the user’s program. 
The system stores the sense switch settings in the control point area and copies them to 
address RA of the user’s area for use by the central program. The system operator can 
change these switch settings by console command. 

OFFSW CARD 

Control card format: OFFSW (n^ n^, ♦ . ♦ , n^) 

Pseudo-sense switch number; 1 < n < 6. 

The OFFSW control card clears pseudo-sense switches for reference by the user’s program. 
The system stores the sense switch settings in the control point area and copies them to 
address RA of the user's area for use by the central program. The system operator can 
change these switch settings by console command. 
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MODE CARD 


Control card format: MODE(n) 

n Exit Condition 

0 Disable Exit mode; no selections made 

1 Address is out of range because: 

• Attempt was made to reference central memory or 
extended core storage outside established limits 

• Word count in extended core storage communication 
instruction is negative 

• Attempt was made to reference last 60-bit word 
(word 7) in relative address FL ECS 

2 Operand out of range; floating-point arithmetic unit received an 
infinite operand 

3 Address or operand is out of range 

4 Indefinite operand; floating-point arithmetic unit received an 
indefinite operand 

5 Indefinite operand or address is out of range 

6 Indefinite operand or operand is out of range 

7 Indefinite operand, operand is out of range, or address is out of 
range 

The MODE control card selects the exit or stop conditions for the CPU program. When MTR 
executes an exchange jump, the exit selection code enters the CPU. The exit occurs as soon 
as the selected condition arises. If the user does not specify an error mode, the system 
assumes n=7. 

COMMENT CARD 

Control card format: COMMENT, comments or 

^comments 

comments Combination of characters the user wishes to display 

The system displays the combination of characters following the period or asterisk on a 
COMMENT control card and enters them into the dayfile. 


EXIT CARD 

Control card format: EXIT. 
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The EXIT card separates the control cards for normal execution from those used when an 
error exit occurs. When the error exit condition occurs, the system searches the control 
card record for the next EXIT card. If the record does not contain an EXIT card, the sys¬ 
tem terminates the job. If the system finds an EXIT card, it clears the error condition and 
obeys the subsequent control cards. Appendix D describes the error messages. 


MAP CARD 

Control card format: MAP. 

The MAP card sets the Loader Map flag for the control point. The loader will generate a 
core map for the job. 

PARTIAL MAP CARD 

Control card format: MAP(P) 

The MAP card with a defined parameter sets the Partial Map flag for the control point. A 
full MAP card or NOMAP card clears the Partial Map flag. 

NOMAP CARD 

Control card format: NOMAP. 

The NOMAP card clears the Loader Map flag for the control point. The loader will not 
generate a core map for the job. 

REDUCEFL CARD 

Control card format: REDUCEFL. 

The REDUCEFL card clears the No Reduce FL flag for programs which normally reduce 
field length for the job. 

NOREDUCE CARD 

Control card format: NOREDUCE. 

The NOREDUCE card sets the No Reduce FL flag for the job. 

ROLLOUT CARD 

Control card format: ROLLOUT. 

The ROLLOUT card requests that the user’s job be rolled out so that all memory assigned 
to the job (except the control point area) can be released. 
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SETPR CARD 


Control card format: SETPR(p) 

p priority level; 1 < p < 17. 

The SETPR control card allows the user to specify a new priority level for his job. 

SETTL CARD 

Control card format: SETTL(t) 

t Central processor time limit in octal seconds (maximum 77770g) 

The SETTL control card permits the user to specify a new time limit for his job. 


PROGRAM EXECUTION CONTROL CARDS 

These control cards direct loading and execution of files. Program execution control cards 
have the general format: 

name list comment 

The card is a unit record of up to 80 characters, including freely interspersed spaces. 

The name and list fields are required and comment is optional. The name is a string of one 
to seven alphanumeric characters. The comment is a string of Hollerith characters. 

The list contains parameters to be used by the program being loaded. The contents of the 
list can vary greatly, depending on the requirements of the program being loaded. If para¬ 
meters are not required, list is simply a period. Parameters can be enclosed in parentheses 
or preceded by a comma and terminated by a period. The list can contain as many para¬ 
meters as fit on one card. The program being loaded dictates the form of the parameters 
to be used. The parameters can specify the type of information flow, input BCD output, 
binary output, special information, or the name of a file involved. 

LOAD CARD 

Control card format: LOAD (lfn;{^) or 

LOAD (Ifn^, lfn 2 , . . . , Ifn^) 

Ifn^^ Name of file to be loaded 

lfn 2 -lfnj^ Names of library files (other than the system library) from which 

to satisfy external references of Ifn^ (0 < n < 50) 

The LOAD card directs the system to load the file Uni, programs from files lfn2 

through Ifn^^ required to satisfy external references occurring in Ifn^ into central memory. 
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Files lfn 2 through Ifn^^ must reside in mass storage. Loading begins from the current file 
position. Loading of Ifn^ terminates when the EOI mark or an empty record appears. The 
user can load segments and relocatable binary decks with the LOAD control card. 

Use a LOAD card for each complete file required. The first record of the first file deter¬ 
mines the kind of loading for subsequent LOAD cards. 

SATISFY CARD 

Control card format: SATISFY (Ifn^, Ifn^, . . . , Ifn^) 

Ifn;^ Names of library files (other than the system library) from 

which to satisfy external references 

For the SATISFY card, the system loads the programs from files Ifn^ through Ifn^ required 
to satisfy external references in a file that the system has already loaded into central mem¬ 
ory as a result of a LOAD card. 

File Ifni reside in mass storage when a SATISFY card appears. 

EXECUTE CARD 

Control card format: EXECUTE (name, p^, P 2 , . . . , p^^) 

name Program entry point where execution is to begin. If name is absent, 

the system uses the last transfer address (XFER) encountered 

p^ List of parameters 

The EXECUTE card causes the loader to complete program loading. This includes filling 
all unsatisfied references with entry points from the system library except where inhibited 
by segment parameters. 

For segment or overlay operations, program execution begins in the first segment or the 
main overlay. 

PROGRAM CALL CARD 

Control card format: Ifn (p^, P 2 * • • • ^ 

Ifn Program name and entry point where execution is to begin 

p^ List of parameters 

The system searches the File Name Table/File Status Table for a file named Ifn. If it finds 
file Ifn, it loads the file subprograms and bypasses any routines already loaded by LOAD 
cards. The system rewinds the file before loading begins. If the system does not find the 
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file named Ifn in the FNT/FST, it searches the system library and loads a subprogram with 
the same Ifn name. When the system completes loading, and if it finds no fatal errors, it 
passes the parameters to the requested program and begins execution at the entry point 
named Ifn. 

Examples : 

EXECUTe”^^^ equivalent to: ESTE. 

To replace one subprogram with a subprogram of the same name from another 
file, the sequence could take the form: 

LOAD (HOST) 

GUEST. 

The subprograms will be loaded from the file HOST and the system bypasses 
the subprograms of the same name on GUEST. 

FORTRAN CARD 

Control card format: RUN (cm, fl, bl, if, of, rf, Ic, as, cs) 

cm Compiler mode option; if omitted, the system assumes cm = G; 

if unrecognizable, the system assumes cm = S. 

cm Mode 

G Compile and execute; do not list unless explicit 

LIST cards appear in the deck 

S Compile with source list; do not execute 

P Compile with source list and punch deck on file 

PUNCHB; do not execute 

L Compile with source and object list; do not execute 

M Compile with source and object list; produce a 

punch deck on file PUNCHB; do not execute 

fl Object program field length (octal); if omitted, the system sets fl = 

field length at compile time. 

bl Object program I/O buffer length (octal); if omitted, the system 

sets bl = 20223 

if Name of file containing compiler input; if omitted, the system 

assumes if = INPUT 

of Name of file to receive computer output; if omitted, the system 

assumes of = OUTPUT 

rf Name of file to receive binary information; if omitted, the 

system assumes rf = LGO 
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Line limit (octal) of the object program OUTPUT file; if omitted, 
the system assumes Ic = IOOO 3 ; if the line count exceeds the line 
limit, the system terminates the job 

as ASA switch; if non-zero or non-blank, causes ASA I/O list/format 

interaction at execution time. 

cs Cross reference switch; produces a cross reference listing 

The RUN control card calls the FORTRAN compiler to the job control point. 


COMPASS CARD 


Control card format: COMPASS (pj^, p 2 ,.*.,Pj^) 

Pj^ Parameters; can be in the following format: 

a 

a = fname 
a = 0 


Option 

A 

B 


B=0 


Meaning 

Source is MODIFY compressed symbolic. If A is 
omitted, no A option is assumed. 

Binary on file LGO. If no B parameter is supplied, 
this option is assumed. 

No binary. 


B = fname Binary on file fname. 

D Generates binary even if there are assembly errors. 

If D is omitted, no D option is assumed. 


LO 


LO-0 


Select list options: CFGX. 

Normal list options. Options L and R are set. 


LO=chars Select list options according to the character string 
”chars'\ 

Character Lists 

L Normal listing 

R Reference information 

G Lines that result in code generation 

A Lines with — or / marks removed 

C EJECT, SPACE, and TITLE control cards 

D Detailed code not normally listed 

E All iterations of duplicated code 

F Lines skipped by IF-type instructions 

M Lines generated by macro calls 

S Lines generated by systems macros 

X Lines generated by XTEXT instruction 
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I 


Input from file COMPILE. 

I=fname Input from file fname. 

When the I parameter is omitted, the system assumes 
I=INPUT. 

L Long list on file OUTPUT. When the L parameter is 

omitted, this option is assumed. 

L=0 No long list. 

L=fname Long list on file fname. 

O Short list on file OUTPUT. When the O parameter is 

omitted, this option is assumed. 

0=0 No short list. 

0=fname Short list on file fname. 

P Select consecutive page numbering. When P is 

omitted, no P option is assumed. 

S System text name SYSTEXT. When S is omitted, this 

option is assumed. 

S=0 No system text. 

S=sname System text name sname. 

X External text from file OPL. When X is omitted, this 

option is assumed. 

X=fname External text from file fname. 

The COMPASS control card calls the COMPASS assembler to the job control point. 

MODIFY CARD 

Control card format: MODIFY (p., p„, . . . , p ) 

i o n 

p^ Parameters; can be in the following general formats: 

a 

a = fname 
a = 0 

Options Specify 

I Use directive input from file INPUT 

I=fname Use directive input from file fname 
1=0 Use no directive input 
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Options 


Specify 


P 

P=fname 

P=0 

C 

C=fname 

C-0 

N 

N=fname 

N=0 

S 

S=fname 

S-0 

L 

L=fname 

L=0 

LO 

LO=chars 


A 

D 

F 

U 

NR 

X 


Use file OPU for old program library 
Use file fname for old program library 
Use no old program library file 

Write compile output to file COMPILE 
Write compile output to file fname 
Write no compile file 

Write new program library on file NPL 
Write new program library on file fname 
Write no new program library 

Write source output on file SOURCE 
Write source output on file fname 
Write no source output 


List output on file OUTPUT 
List output on file fname 
List no output information 


Select list options: ECTMWDS 

Select list options according to the character 
string "chars’*: 


Character 


Lists 


E Errors 

C Directives other than INSERT, 

DELETE, RESTORE 
T Input text 

M Modifications made 

W Compile file directives 

D Deck status 

S Statistics 

I Inactive cards 

A Active cards 


Any combination of characters selects the 
combination of list options. 


Write compressed compile file 
Ignore errors 
Modify all decks 

Modify only decks mentioned on DECK directives; 

F overrides U option 

Do not rewind compile file 

Rewind input and output files, set A option, and call 
COMPASS assembler when modification is completed 
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X=prog 


Rewind input and output files, set A option, and call 
the prog processing program when modification is 
completed 

X=0 Do not call another processing program 

The following options apply only if the X option is selected. 

CB Set assembler argument B^LGO 

CB=name Set assembler argument B=name 
CB=0 Set assembler argument B=0 

CL Set assembler argument L=OUTPUT 

CL=name Set assembler argument L=name 
CL=0 Set assembler argument L=0 

CS Set assembler argument S^SYSTEXT 

CS=name Set assembler argument S=name 
CS=0 Set assembler argument S=0 

With the MODIFY control card, the user calls the MODIFY program to his control point to 
edit a library file. The parameter list specifies additional information to MODIFY. The 
parameters can be in any order and are not mandatory. For any or all parameters omitted 
from the control card, the system uses a default value: 


I 

= INPUT 

LO = ECTMWDS 

NR deselected 

p 

= OPL 

A deselected 

o 

II 

X 

C 

= COMPILE 

D deselected 

CB 

N 

= 0 

F deselected 

CL = 0 

S 

= 0 

U deselected 

CS 

L 

= OUTPUT 




NOGO CARD 

Control card format: NOGO. 

When the loader encounters a NOGO card, it processes the loaded program in the same 
manner as for an EXECUTE card; however, it does not execute the program. This card 
permits program mapping, execution bypassing, and continuation of other portions of the job. 

FILE MANAGEMENT CONTROL CARDS 

The file management control cards permit the user to: 

• request a file in a particular type of output, 

• assign a file to a particular device. 
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• route a file to a particular destination, 

• create a COMMON file, 

• attach a COMMON file, 

• change a LOCAL file to a COMMON file, and 

• release a COMMON file. 

If a file is not specifically assigned to a REQUEST or ASSIGN card, the system assigns it 
to disk storage. A job does not assign the card reader, printer, or punch for normal input/ 
output from such things as compilations or assemblies since the system does this automati¬ 
cally. In addition, any file named OUTPUT, PUNCH, or PUNCHB will always be printed, 
punched, or punched binary by the system at job completion. The REQUEST card is used 
for large installations where the operator can best assign the available equipment when any 
peripheral device of a particular type is suitable. The ASSIGN card is for smaller installa¬ 
tions and situations where only one particular peripheral device is suitable. 

REQUEST CARD 

Control card format: REQUEST (Ifn, x^, , x^) 

Ifn Logical file name; one to seven digits or letters. This is the name of 

the file to which equipment is to be assigned, and the name by which the 
user refers to the file within his program. A REQUEST card must have 
at least one parameter; the first parameter is the Ifn. 

Any of the following: 


LO 

Density = 200 bpi 


HI 

Density = 556 bpi 


HY 

Density = 800 bpi 


X 

Process coded data in unblocked External BCD (136 
characters/PRU unless otherwise specified). (Section 1) 

B 

Process coded data in blocked External BCD (150 
acters/PRU unless otherwise specified). (Section 

char- 

1 ) 

C=xxxx 

Set External BCD character count per PRU=xxxx; 

1 < xxxx < 4,096. Any value not in this range is 
ignored without comment and standard values are 



used 

The user can fill his REQUEST card with x. parameters. If parameter commands conflict, 
TSOS ignores all except the last parameter given. 

The REQUEST card directs the system to display (at the system console) the user’s request 
to assign a file to a peripheral device. The comment on the REQUEST card can specify the 
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acceptable type of device. When the system operator assigns the peripheral equipment, job 
execution commences. Any equipment the user wishes to use must be requested on a RE¬ 
QUEST card or assigned on an ASSIGN card. 

Because the system processes control cards in order, the REQUEST card must appear be¬ 
fore the user references the file. If a parameter appears more than once or is illegal, the 
system issues a message and aborts the job. 

ASSIGN CARD 

Control card format: ASSIGN (nn, Ifn, , x^) 


nn 

Ordinal in 

equipment Status Table (EST) of peripheral device or 


equipment type: 


Type 

Equipment 


CP 

Card punch 


CR 

Card reader 


DA 

6603 disk 


DB 

6638 disk 


DC 

863 drum 


DD 

854 disk drive 


DE 

Extended core storage 


DF 

814 disk 


DG 

Disk drive group 


LP 

Dine printer 


MT 

1/2 -inch magnetic tape 

Ifn 

Name of file to be assigned 

X. 

1 

Any of the following: 


LO 

Density = 200 bpi 


HI 

Density = 556 bpi 


HY 

Density = 800 bpi 


X 

Process coded data in unblocked External BCD (136 
characters/PRU unless otherwise specified). (Section 1) 


B 

Process coded data in blocked External BCD (150 char¬ 
acters/PRU unless otherwise specified). (Section 1) 


C=xxxx 

Set External BCD character count per PRU=xxxx; 

1 < xxxx < 4,096. Any value not in this range is 
ignored without comment and standard values are 


used 
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The user can fill his ASSIGN card with parameters. If parameter commands conflict, 
KRONOS ignores all except the last parameter given. 

The ASSIGN card directs the system to assign equipment nn to file Ifn. The system will 
refuse to assign the equipment if the user is not allowed to use the device or the file is 
already assigned to another device. 


SETID CARD 

Control card format: SETID (Ifn. = a., Ifn,. = a^, . . , , Ifn = a ) 

11 2 2* n n 

Ifnj^ Logical file name 

a^ New area code for file 

The SETID card assigns a new area code or changes the area code for file Ifn. The area 
code allows the user to route his file to a particular output device or device group because 
of proximity or other considerations. 


COMMON CARD 

Control card format: COMMON (Ifn., Ifn^,, . . . , Ifn ) 

\ 2 n 

Ifn. Name(s) of COMMON file(s) 

If file Ifn^^ is a COMMON file in the FNT/FST and is not being used by another job, the sys¬ 
tem assigns it to this job. If the file is being used by another job or is not a COMMON file, 
the job must wait until the file is available. 

If file Ifn appears as a LOCAL file for the job, the system changes it to a COMMON file in 
the FNT/FST and it becomes available to any succeeding job after the current job terminates. 
However, if a COMMON file of the same name already exists, the system rejects the COM¬ 
MON request and allows the job to continue. 

If the file resides on a non-allocatable device such as magnetic tape, the equipment is re¬ 
served until the user releases the COMMON file. 


RELEASE CARD 

Control card format: RELEASE (Ln^ • • • > ^^^n^ 

Ifn^ Logical file name 

For the RELEASE card, the system changes COMMON file Ifn^^, currently assigned to the 
job, to a LOCAL file in the FNT/FST. The file is then discarded at the end of the job unless 
the user program changes the file type by a subsequent file manipulation request. 
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LOCK CARD 


Control card format: LOCK (Ifn^, ^^^2^ • • • > 

Ifn- Logical file name of a LOCAL file 

With the LOCK card, the user can set the write lockout for local file Ifn. Subsequently, the 
system allows only read operations on the file, 

UNLOCK CARD 

Control card format: UNLOCK (Ifn., Ifn^, . . , , Ifn ) 

1 z n 

Ifn^ Logical file name of a LOCAL file 

With the UNLOCK card, the user can clear the write lockout (rescind a LOCK command for 
local file Ifn). 

MACE CARD 

Control card format: MACE. 

The MACE card clears the SCOPE bit for loading of a file. 

SCOPE CARD 

Control card format: SCOPE. 

The SCOPE card sets the SCOPE bit for loading of a file. 

PERMANENT FILE CONTROL CARDS 

SAVE CARD 

Control card format: SAVE, Ifn, = pfn,, .... Ifn = pfn 

11 n n 

Local file name; name of the file to be saved 

Permanent file name; name under which the file is to be 
stored on the permanent file device. (If omitted, pfn^ =1^^) 

The SAVE control card permits the user to retain files in the permanent file system. As 
many files as can be specified on one control card can be retained with each SAVE command. 
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GET CARD 


Control card format: GET, Ifn^ = pfn^, . . . , Ifn^ = pfn^, ACCOUNT = xxxxxxx . 

Local file name; name given to the file when in use 

Pfn^ Permanent file name; name of the permanent file to be 

retrieved. (If omitted, pfn^ = Ifn^) 

xxxxxxx The user number of another user; given when a user wishes to re¬ 

trieve the file(s) of another user (provided permission has been granted) 

The GET control card enables the user to retrieve a file from permanent file storage. As 
many files as can be specified on one control card can be retrieved with each GET command. 


REPLACE CARD 


Control card format: REPLACE, lfnj^=pfn]^, . . ., Ifn^ = pfn^^, ACCOUNT = xxxxxxx. 

Ifn- 

Local filename; name of the new file that will be placed on the 
permanent file device 

pfn. 

Permanent file name; name of the file that is replaced 
(If omitted, pfn. = Ifn.) 

xxxxxxx 

The user number of another user; given when the user wishes to 
replace the file(s) of another user (provided permission has been 

granted) 


The REPLACE control card permits the user to substitute a new file for an old file on the 
permanent file device. As many files as can be specified on one control card can be re¬ 
placed with one REPLACE command. 


PURGE CARD 

Control card format: PURGE, pfn^, ..., ACCOUNT = xxxxxxx. 

pfn. Permanent file name; name of the file to be removed from the 

permanent file system 

xxxxxxx The user number of another user; given when a user wishes to re¬ 

move a file of another user from the permanent file system (provided 
permission has been granted) 

The PURGE control card permits the user to remove a file from the permanent file device. 

As many files as can be specified on one control card can be purged with one PURGE card. 
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PERMIT CARD 

Control card format: PERMIT, pfn, MODE = y, accnum^^, . . . , accnum^. 

pfn Permanent file name; permanent file on which permission is to 

be granted. 

y Permission level. The possible permission levels are: 

A — append only 
E — execute only 

N — none, removes previously granted permission 
R — read and/or execute 
W — write, read and/or execute 

accnum^ The user numbers of persons to be granted access to file pfn 

The PERMIT control card allows a user to grant file access to other users. As many users 
can be granted permission as user numbers can be contained on one control card. 

APPEND CARD 

Control card format: APPEND, Ifn^, pfn^, ..., ACCOUNT = xxxxxxx. 

Ifn- Name of the local file to be appended to the permanent file 

pfn^ Name of the permanent file to which the local file is to be appended 

xxxxxxx The user number of another user; given when a user wishes to 

append the file(s) of another user 

The APPEND control card permits the user to attach supplementary information to an exist- 
ing file. The files Ifn. and pfn. must always appear in pairs. 

CATLIST CARD 

Control card formats: CATLIST. or 

CATLIST, F. or 
CATLIST, xxxxxxx. 

F Specifies a full listing including the file length, creation date, 

and last access date of each permanent file 

xxxxxxx User number of another user; allows a user to obtain a listing 

of the files he can access in the catalog of user xxxxxxx. 

The permanent file catalog control cards permit the user to obtain information about the 
files to which he has access. If a user has been granted access to the permanent files of 
user xxxxxxx (through the use of the PERMIT card), he can obtain a listing of the files to 
which he has access by specifying the user number xxxxxxx. 
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PROGRAM/SYSTEM COMMUNICATION 


4 


In addition to control cards, KRONOS provides a comprehensive set of system macros that the 
user’s program can call to control input/output operations, request file manipulations, and 
communicate with the system at execution time. Input/output is accomplished via circular 
buffers. 

During program execution, the system performs three types of operations as the result of 
macro calls: 

• System operations; initiated by job action requests 

• Input/output operations; initiated by file action requests 

• File manipulations; initiated by file action requests 

For file manipulation and input/output operations, the user must establish a File Environ¬ 
ment Table (FET) for the pertinent file. The FET contains the circular buffer parameters 
for the operation. For FORTRAN or other compiler language input/output, the user should 
not be concerned about circular buffers and FET’s as the compiler automatically provides 
these. 

Moreover, the system does not require the FET to process job action requests. 

This section describes circular buffers. File Environment Table, user/system communica¬ 
tion subroutines, job action requests, and file action requests. 

CIRCULAR BUFFERS 

A circular buffer is a temporary storage area in central memory that contains data during 
input/output operations. It is called circular because routines that process input/output 
treat the last word of the buffer area as contiguous to the first word of the buffer area. The 
buffer parameters (FIRST, IN, OUT, and LIMIT) in the FET describe the circular buffer 
(see Figure 4-1). 

FIRST 

FIRST is the first word address of the buffer area. Routines that process I/O never change 
the value of FIRST. 
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LIMIT 


LIMIT is the last word address plus one of the buffer area. Data is not stored in LIMIT. 
When LIMIT is reached, the next available address for storage is FIRST. Routines that 
process I/O likewise never change the value of LIMIT. 


FIRST 



IN 


OUT 


LIMIT 



Figure 4-1. Circular Buffer 


OUT 

OUT is the next location to read to remove data from the circular buffer. Either the system 
or the calling program changes OUT depending on whether the operation is a write or a 
read (see Figure 4-2). 


CALLING 

PROGRAM 


IN 


■> 



OUT 


> SYSTEM-> 


Figure 4-2. Write Operation 
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IN 

IN is the next location to write data into the circular buffer. Either the system or the call¬ 
ing program changes IN depending on whether the operation is a read or a write (see Figure 
4-3). When IN = OUT, the buffer is empty. When IN = OUT-1, the buffer is full. 


OUT 

CALLING 

< - 

PROGRAM 



IN 


<- SYSTEM ^ 


Figure 4-3. Read Operation 

That is, one location is left empty in a full buffer to distinguish an empty buffer from a full 
buffer. A buffer is normally initialized with IN = OUT = FIRST, and IN and OUT circle the 
buffer as data is inserted and extracted. 

FILE ENVIRONMENT TABLE 

As introduced, the FET is a user-initiated communication area. The system and the user 
interrogate and update the FET during job execution. An FET within the user’s field length 
must be initiated for each file of the user’s job. The PPU I/O routine (CIO), CPU I/O sub¬ 
routines, and the user’s program access the system portion of the FET. A user section 
can be appended to the system FET to centralize other pertinent file information. The 
format of the system FET is shown in Figure 4-4. 


59 47 44 35 32 29 23 17 0 


Logical File Name (Ifn) 

Code and Status 

Device Type 


FIRST 

0 

IN 

0 , 

OUT 

FNT Pointer 

Record Block Physical Record 

Size Unit Size 

LIMIT 


Working Storage 
two 


Working Storage 

1 wa +1 

Current Random Address 

Random Request/Return Information 


Words 


2 

3 

4 

5 

6 
7 


Figure 4-4. System File Environment Table 
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The following lists describe the user and system information that appear in the system 
portion of an FET: 


USER INFORMATION 

Parameter 
device type 


record block size 

physical record 
unit 

SYSTEM INFORMATION 

Parameter 
logical file name 


Word (Bits) 
2 (48-59) 


5 (33-47) 


5 (18-32) 


Description 


The system sets the device type in this byte 
when the user’s program makes an OPEN 
request. 


Possible device types are: 

Code Device 

0401 6603 disk unit 

0402 6638 disk unit 

0403 836 drum 

0404 854 disk drive 

0405 Extended core storage 

0406 814 disk 

0407 Disk drive group 

5524 1/2-inch magnetic tape 

5420 Line printer 

4322 Card reader 

4320 Card punch 


The device code is the display code for the 
device mnemonic with the most significant 
bit set for non-allocatable devices. 


If the file resides in allocatable storage, the 
system returns the size of the device record 
block in this field at OPEN time. It is the 
number of physical record units in a record 
block. If the number of PRU’s is not defined 
or is variable, the field is zero. 

KRONOS returns the physical record unit size of 
the device to which the file is assigned in this 
field at OPEN time. It is the number of 
central memory words in a PRU. 


Word (Bits) Description 

1 (18-59) The Ifn field contains one to seven alphanu¬ 

meric display code characters, left-justified; 
unused characters are zero-filled. This field 
is a common reference point for the CPU pro¬ 
gram and PPU I/O routines. The Ifn para¬ 
meter, declared in an FET creation macro, is 
also the location symbol associated with the 
first word of the FET. Thus, a reference to Ifn 
in a file action request is a reference to the 
base address of the FET. 
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Parameter 


Word (Bits) 


Description 


code and status 


r 


up 


ep 


i 


1 ( 0-17) 


1 (9-13) 


1 ( 1 - 8 ) 

1 ( 1 ) 

1 ( 0 ) 

2 (47) 

2 (45) 


2 (44) 


2 (18-23) 


The code and status field communicates requested 
function codes and resulting status between the 
CPU program and the PPU I/O routines. The 
CPU program sets the request code in this field 
when it encounters a request for this file. The 
request codes are defined in the file action re¬ 
quest descriptions and summarized in Appendix C. 
This field is initialized to one. 

Status information when request is complete; 
zero field indicates normal completion; non¬ 
zero field indicates abnormal completion (not 
necessarily an error). 

Request code for PPU call; these codes are 
defined in the file action request descriptions. 

File mode; 0 = coded, 1 = binary. 

Completion bit; 0 = busy or not complete, 

1 = not busy or complete. 

Random access bit; set to 1 if this is a random 
access file. 

User processing bit; set to 1 to notify the calling 
program an End-of-Reel condition has been en¬ 
countered during a 1 / 2 -inch magnetic tape oper¬ 
ation. If the up bit is set to 0, tape swapping 
proceeds automatically without notification to the 
calling program. The system completes the 
function being processed on the alternate tape 
reel. 

When the up bit is set to 1, and an End-of-Reel 
condition arises during a 1 / 2 -inch magnetic tape 
operation, the system sets an End-of-Reel status 
( 623 ) in bits 9-13 of the code and status field. 

Error processing bit; set to 1 to notify calling 
program of error conditions. If ep bit is set to 
0 , the operator must correct fatal errors when 
they arise. 

FET length; FET first word address +5+i = last 
word address +1. The minimum FET length is 
five words (i =0). If the minimum FET is used, 
only the logical file name, code and status field, 
FIRST, IN, OUT, and LIMIT are relevant. KRONOS 
does not set or check any other field. A length of 
six words is used if a working storage area is 
needed for blocking/deblocking. A length of eight 
words is used if the r bit is set, indicating a 
random file. 
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Parameter 

Word (Bits) 

Description 

FNT pointer 

5 (48-59) 

KRONOS sets the address of the corresponding FNT/ 
FST entry for the file in this byte when it pro¬ 
cesses a file action request for the file. If the 

FET is of minimum length, the system does not 
set this pointer. 

FIRST 

2 (0-17) 

The first word address of the buffer area; rou¬ 
tines that process I/O never change the value of 
FIRST. 

IN 

3 (0-17) 

The next location to write data into the circular 
buffer; either CIO or the calling program changes 

IN depending on whether the request is for a read 
or a write operation. When IN^OUT, the buffer is 
empty. When IN=OUT-l,the buffer is full; that 
is, one location remains empty in a full buffer to 
distinguish it from an empty buffer. The upper 
bits of location 3 of the FET are zeros to elimin¬ 
ate the need for masking. 

OUT 

4 (0-17) 

The next location to read or remove data from 
the circular buffer; either CIO or the calling 
program change OUT depending on whether the re¬ 
quest is for a write or a read operation. The 
upper bits of location 4 of the FET are zeros to 
eliminate the need for masking. 

LIMIT 

5 (0-17) 

The last word address plus one of the buffer area; 
no data is stored at address LIMIT. When LIMIT 
is reached, the next available address for reading 
or writing is FIRST. Routines that process I/O 
never change the value of LIMIT. 

working storage 
fwa 

6 (30-47) 

First word address of a working storage area 
from which data can be blocked into or deblocked 
from the circular buffer. 

working storage 

Iwa + 1 

6 (0-17) 

Last word address plus one of the working 
storage area (above). 

current random 
address 

7 (36-59) 

Specifies file position if the file is a mass 
storage random access file. 

random request/ 
return information 

7 (0-35) 

Used for communication between the random 
access functions and the PPU I/O routines; 
initially set to zero. 
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FET CREATION MACROS 


System macros in the COMPASS language facilitate generation of the system FET. The 
following paragraphs describe FET creation macros. 


CODED FILE (SEQUENTIAL) 

Ifn FILEC fwa, f, (WSA = addr , 1 ), UPR, EPR, (FET=U 
^ ^ w w f 


BINARY FILE (SEQUENTIAL) 

Ifn FIL.EB fwa, f (WSA = addr , 1 ), UPR, EPR, (FET=1J 

w w ' ' ' f 


CODED FILE (RANDOM) 

IfnRFILEC fwa, f, (WSA = addr , 1 ), (IND = addr., L), UPR, EPR, (FET-U 

W W * 11* * * f 


BINARY FILE (RANDOM) 

Ifn RFILEB fwa, f, (WSA = addr , 1 ), (IND = addr., 1.), UPR, EPR, (FET=U 
' w' w * 1 * 1 f 


The last five subfields (WSA, IND, UPR, EPR, and FET) are order-independent (order is 
fixed within the subfield). Upper case characters designate actual subfield content; lower 
case characters indicate parameters to be supplied by the user. All parameters except Ifn, 
fwa, and f are optional. 


Ifn 

fwa 

f 

WSA 

addr 

w 

1 

w 

IND 

addr. 

1 

1 . 

1 

UPR 
EPR 
FET= If 


File name 

Substituted in FIRST, IN, and OUT 

fwa + f substituted in LIMIT 

Working storage area parameters 

First word address of working storage area 

addr +1 = last word address + 1 of working storage area 

w w 

Index buffer parameters 

First word address of index buffer 

Length of index buffer 

User desires processing at End-of-Reel 

User desires to handle error conditions 

Length of FET if desired 


Examples : 

To create a minimum FET for the standard INPUT file: 


59150600 Rev. A 


4-7 



INPUT FILEC BUFFER, LBUFFER 
To create an FET for a binary random file: 

FILEABC RFILEB BUFFER, LBUFFER, (IND = INDEX, LINDEX) 

USER/SYSTEM COMMUNICATION SUBROUTINES 

The user communication subroutines provide the linkage between user programs and the 
operating system. All file action requests and job action requests are processed by library 
subroutines, which the system loads with the user program within the field length of the job. 
The program communicates with the subroutines through macro requests and the FET. The 
subroutines communicate with KRONOS through hardware registers and by setting and checking 
RA + 1. 

An exit from the system subroutine returns control to the object program at the point follow¬ 
ing the macro request, and does not save registers. However, the macro descriptions include 
the register usage for the convenience of the user. If the user specifies a macro parameter 
value that is the same as the contents of the register by which the parameter is passed, KRONOS 
does not generate code to set the register to the parameter value. Therefore, suitable 
choice of registers improves the generated code. 


JOB ACTION REQUESTS 

Job action requests use the Al, XI, A6, X6 registers unless otherwise specified in the 
descriptions. Job action requests are: 



MEMORY 

• 

CLOCK 

• 

EREXIT 


RECALL 

• 

DATE 

• 

OVERLAY 


MESSAGE 

• 

SYSTEM 

• 

ROLLOUT 


ENDRUN 

• 

CONSOLE 

• 

MODE 


ABORT 

• 

ONSW 

• 

SET PR 


TIME 

• 

OFFSW 

• 

SETTL 


• RTIME 

When a job action request parameter represents an address expression, the parameter can 
be: 

• a register name, 

• a relocatable address, 

• an external symbol name, or 

• an absolute address. 
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MEMORY FUNCTION 


Using the MEMORY function, the user^s program can determine or change the length of 
central memory assigned to the job control point. Before issuing the MEMORY request, 
the user should establish a one-word parameter list at location stat: 


59 


29 


0 


stat 


000000000 


00000000000 


words 


Set non-^zero on completion. 


Macro format: 


I 

LOCATION 

OPERATION 

ADDRESS 

:■ 

BBqBqBDBD 

D ^3 ^3 ^9 ^3 ^3 ^3 



1 

■MMI 

]VJE|]VI|0|R|Y, 

1 

t lYiPiei, |S|t|a|t|,|r|, | 

[ 

W|Oir,d,si 1 1 


type CM or null 

stat Address of status word 

r If non-null, indicates recall status 

words Desired new field length 


RECALL FUNCTION 

Using the RECALL function, the user can relinquish the CPU until: 

• an I/O process is completed, or 

• the next time through the monitor loop, 

depending on the form of the request. If the Ifn parameter is included in the macro call, 
control does not return to the relinquishing program until the completion bit in the FET for 
file Ifn is set. If the Ifn is not included in the macro call, the user relinquishes the CPU 
only until the next time through the monitor loop. 


Macro format: 



LOCATION 

OPERATION 

ADDRESS 

[ 

2 3 4 S 1 6 7 8 S to 

)l|l2 13 I4|l5 16 IT 

18 19 20 21 22 23 1 24 25 26 2 7 28 29 30 31 32 35 34 j 35 36 


...i I 1 1. J 1 1 1 

R,E|CtA,L|L| 

Pi 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


Ifn Logical file name (optional) 
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MESSAGE FUNCTION 


Using the MESSAGE function, the user can display a message on the console scope and enter 
it in the day file. 

The maximum message length is 40 ^q characters. The message ends at the first word with 
all zeros in bits 0-11 or at the 40th character, whichever comes first. Before issuing the 
MESSAGE function, the user should pack his message (in display code) from higher-numbered 
bits to lower-numbered bits in sequential locations starting with location addr. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2[3|4|5|«|7|8|»|lO 

11 1 izj tsj14 115 1 16 1 17 


zojzi122|23 

24|25 

26| 27| 26 I 29 

30|3t 1 32|35|34j35|36| 


1 i 1 1 t 1 1 1 

]\fE;S|S^pp 

Ll-J 

I 1 1 1 1 1 1 1 


addr Beginning address of list containing the message 

X Message route 

X = 0; message to system dayfile 
X = 1; display on line 1 
X = 2; display on line 2 
X = 3; message to user’s dayfile only 
r If non-null, indicates recall status 


ENDRUN FUNCTION 

By issuing an ENDRUN function, the applications program requests normal termination of 
a run. KRONOS examines the control card record of the job deck and begins execution with the 
next unused control card. If there are no more control cards, or if the next card is an EXIT 
card, the system terminates the job. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2 | s |.|»|.| 7 |.|, |,0 

OBS^3^3EID 

DD 



1 1 1 1 1 1 1 1 

E|]S5r:|RiU|N| 
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ABORT FUNCTION 


When an error such as an out-of-bounds memory reference occurs, the user can request 
the monitor to terminate the job abnormally by using the ABORT function. If the control 
card section of the job deck contains an EXIT card, the system continues processing the 
job with the control card immediately following the EXIT card. 

Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 


D B3fl9 ^3 IS B3 B3 


^SGfl ^9 S EB ^9 1 

1 

miiiiii 


■miBiHi 

mHm 


TIME FUNCTION 


For the TIME function, the system returns the central processor time used by the job in 
location stat: 

59 35 11 0 


stat 


Macro format: 


undefined 


seconds 


milliseconds 



LOCATION 

OPERATION 

ADDRESS 

1 

4|5 6 to 

1 1 1121 isj 14 115 1 16 IT 

18 1 isj 20|2l I 22|23|24| 25|26| 27 1 2e| 29 

30|3I 1 32|35| 341 ssj Sej 


1 1 1 1 1 1 1 1 

r,! ,M|E| 1 , 

^ 1^1^ ih 1 1 1 1 1 1 1 

I 1 1 1 1 1 1 1 


stat Address to receive the CPU time 


RTIME FUNCTION 

For the RTIME function, the system returns the real-time clock reading in location stat. 
59 35 11 0 


stat 


undefined 


seconds 


milliseconds 
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Macro format: 



LOCATION 

OPERATION 

ADDRESS 

t 

2|3|4|5|«|7|8|»|)0 

11 1 lajisj 14 j15 1 16 1 17 

18119jaojai]22|23 

24 ]25jae]271 28 

29 

3o|3I j 32 jisj 34j 35 



1 1 1 1 1 1 1 1 

R|T|1|]\^E| 1 

S|t|a|t| 1 1 1 1 1 1 1 

1 1 1 1 1 1 1 


stat Address to receive the clock reading 


CLOCK FUNCTION 


For the CLOCK function, the system returns current reading of the system clock in location 
stat: 


stat 


59 


0 


hh • mm • ss • 


Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 

BQOBBBBQia 

DQS^l^lEID 

DBBBBBB 

m 



1 

1 I, 1...1 1 

1 

1 1 1 1 1 1 1 



stat Address to receive the clock reading 


DATE FUNCTION 

For the DATE function, the system returns the current date typed by the operator in loca¬ 
tion stat: 


stat 


59 


0 


mm / dd / yy • 


Macro format: 



LOCATION 

OPERATION 

ADDRESS 

t 

2|s 4 8|6|7|8|9|t0 

II j12 13 14 1 15 16 j 17 

18 19 20 21 22 23 24 25 26 27 281 29 30 31 32 35 34 35 36 


1 1 1 1 1 1 1 1 

D|AT|E| 1 1 

1 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


stat Address to receive the clock reading 
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SYSTEM FUNCTION 


With the SYSTEM function, the user can request the system to; 

• recall the central processor, 

• terminate the current CPU program, 

• abort the control point job, and 

• return time information. 

The SYSTEM function requires the X2 register. 


Macro format: 



LOCATION 

OPERATION 

ADDRESS 

I 

2|s|4]9]6|7[8|9jl0 

n112 13 14 IS 1 16 j 17 

te 1 Idjaojzi j 22|23|24|25|26j27| eej 29 

3o|3l 1 32|3S|34|3S|96 


- 1 1 1 1 1 1 1 1 

Siyp|T|E|]\4 

r |e|q|. |r |. |P|1|.|P|2| 

1 1 1 1 1 1 IJ 


req Three character system request 

r If non-null, indicates recall status 

pi Bits 0-17 of the request 

p2 Bits 18-35 of the request 


Example: If a user wishes to dump the contents of location 1000 to 4000 octal and recall the 
CPU when the dump is completed, the SYSTEM request is: 

SYSTEM DMP, R, 4000B, lOOOB 


CONSOLE FUNCTION 

The CONSOLE function sets the K display control word to the area defined by addr. 
Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 

BBOBBBBBB 


QSBISBSSBiB3^9^3S 

&3 ^3 

1 

HMHM 

C,0,N|Sp,LjE 


HiHII 


addr Area containing address to receive the display control card 


59 35 17 0 


input buffer address 

right screen 

left screen buffer 


buffer address j 

address 
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ONSW FUNCTION 


The ONSW function sets the sense switches corresponding to bits 0-5 in n. 
Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 

BBOBBDDBia 

0^319^3 ^313&I 


E3 El ^9 ^31 

1 

-1 1 1 1 1 1 1 1 

0|N|S|W| 1 1 


11111111 


n Word containing sense switch references in bits 0-5. 


OFFSW FUNCTION 

The OFFSW function clears the sense switches corresponding to bits 0-5 in n. 

Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 

BBBBBBOBB 

91DDIfllBBBID 

mmm 


1 

1 El.1 

0(F|F|S|W[ 1 



n Word containing sense switch references in bits 0-5. 


EREXIT FUNCTION 

The EREXIT function sets the error exit return address equal to addr. 


Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

■ 

BBDBBBDBB 

DQDDQI3D 



1 

1 1 { 1 I 1 1 1 

E|R,E|5qi |T| 

a|d|d|r| i i | | 1 1 1 

I 1 1 1 1..J 


addr 
return (RA) 


Address set to error exit return address. 


59 

47 

29 

23 

0 


Address 

Error 





Flag 
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OVERLAY FUNCTION 


The OVERLAY function loads an overlay from the system library or from file n. If it is not 
a 0, 0 level overlay, the overlay entry address is returned in XI. 


Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

■ 


DBDDQB3D 


1 

i|i||ii|Q 

D|V,E|R.|L|A|Y 

1 

Pl. |1 I. |S iy|S|t leiiq ,lf|wi a| 1 1 1 1 


n Name of either a file or an overlay, depending on whether the 

system parameter is present. 

1 Name of overlay to be loaded from file n if the system parameter 

is not present. 

system Specifies that the overlay is to be loaded from the system library. 
When omitted, the overlay is loaded from file n. 

fwa Specifies the address at which the overlay is to be loaded. When 

omitted, the overlay is loaded at the overlay origin. 


ROLLOUT FUNCTION 

The ROLLOUT function rolls out the user^s job and releases all memory assigned to the job 
(except the control point area). 


Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

»|,|4|»|.|7|.|,|,0 

11 1 12 1 1 sj 14 1 15 j 16 1 17 

jIB 119 1 2o|2i 1 22j 


|26|26| 27| 

1 28 1 29 1 

1 30|3I j 52|35| 34| ssj 

0 


1 1 1 1 1 i 1 i 

Riqi^i^qu,T 

! 

1 1 1 1 1 1 1 1 1 1 1 1 

1 

1 1 1 1 1 1 1 1 


MODE FUNCTION 

The MODE function requests exit mode n. 
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Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 




30|3I 1 32|3S|34|3S|36| 

1 

111111111 

]VJO|D|E| 1 1 

1 1 1 1 1 1 1 1 1 1 1 

1 1 1 1 1 1 1 1 


IL Exit Condition 

0 Disable Exit mode; no selections made 

1 Address is out of range because: 

• Attempt was made to reference central memory or 
extended core storage outside established limits 

• Word count in extended core storage communication 
instruction is negative 

• Attempt was made to reference last 60-bit word 
(word 7) in relative address FL ECS 

2 Operand out of range; floating-point arithmetic unit received an infinite 
operand 

3 Address or operand is out of range 

4 Indefinite operand; floating-point arithmetic unit received an indefinite 
operand 


SETPR FUNCTION 

The SETPR function sets a new priority level for a job. 
Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

zjs 4 s|«|7 sjs 10 

II 1 izj isj I4| 19 1 16 IT 

16 1 I9|20|2I 1 ZzjzS 

Z4|29|26| 2?! 2b| 29| 3o|3l | 32 34 1 35 | 36| 


1 I 1- 1 111 1 - 

Sp|T|P|R| 1 

1 

... 1 1 1 1 1 1 1 


p Priority level. 1 < n < 17. 
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SETTL FUNCTION 

The SETTL function permits the user to specify a new time limit for a job. 


Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

■ 

BBDBDBODD 



E9SI ESE9^9 

1 

1 1 1 1 1 1 1 1 


1 1 1 1 1 1 1 1 1 1 

11111111 


t Central processor time limit in octal seconds 

FILE ACTION REQUESTS 

File action requests are: 



RETURN 

• STATUS 

• 

WRITER 

• SKIPFF 


EVICT 

• UNLOCK 

• 

WRITE F 

• SKIPEI 


ASSIGN 

• READ 

• 

WPHR 

• BKSP 


COMMON 

• RPHR 

• 

WRITE C 

• BKSPRU 


LOCK 

• READC 

• 

WRITER 

• SKIPB 


RELEASE 

• READH 

• 

WRITES 

• SKIPFB 


RENAME 

• READS 

• 

WRITEW 

• REWIND 


REQUEST 

• READW 

• 

SKIPF 

• UNLOAD 


SETID 

• WRITE 





A file action request results in a return jump to a system subroutine. Subsequent actions 
depend on the state of the file. The subroutine can post a request to KRONOS. After 
KRONOS accepts the request, control returns to the calling program if the recall bit r is 
equal to zero, or after KRONOS completes the request if r is equal to one. For macro 
specifying the optional final recall parameter, r is set to one when recall is present (the 
recall parameter is non-null in the macro call). File action requests use the Al, XI, A2, X2, 
A6, X6, A7, X7 registers except when otherwise specified. The logical file name is always 
passed by the X2 register. 

When a file action request parameter represents an address expression, the parameter may 
be: 

• a register name, 

• a relocatable address, 

• an external symbol name, or 

• an absolute address. 
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The logical file name is the base address of the FET that controls the file for which the 
operation is being requested. 


RETURN FUNCTION 

The RETURN function returns file Ifn to the system. If Ifn is a COMMON file on which the 
system allows other than read operations, RETURN makes the file available to other users. 

Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

2|s 4 5|6 7 8|»|lO 

M 12 13 14 IS 16 IT 

16 1 19|2o|2l 1 22|23|24|2s|z6| 27 1 2s| 29 

30|3I 1 32 j3s|34|35|36j 


1 1 1 1 1 1 1 1 

R|ElT|qR,N, 

.. 1 

|_1..L..J_L 1 U 


Ifn Logical file name 

r If non-null, indicates recall status 


EVICT FUNCTION 

The EVICT function releases to the system all space occupied by a file on disk. It is then 
available for use by either the releasing program or other programs. If the file is a COM¬ 
MON file on which the system allows other than read operations, this function returns the 
file to the system. It is then available to other users. 

Macro format: 


Ifn 

r 



LOCATION 

OPERATION 

ADDRESS 

1 

2 1 J . 1 5 « 1 7 • 9 10 

II 1 tz| I3| I4| IS 1 16 1 IT 

16 1 19 1 zojzi 1 22|23|24j Zsjzel 27|Zsj 29 

30j3l 1 32|33| 34j35|36| 


1 1 1 1 1 1 1 1 

E|V|I|C|T| 1 

1 1 1 1 1 1 

I 1 1 1 1 1 1 1 


Logical file name 

If non-null, indicates recall status 


ASSIGN FUNCTION 

The ASSIGN function assigns common file Ifn to the job. 
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Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 


DQOB3D^3BI 

QIQ QQ Q| Q Q 


^9 ^9 ^0 G9 E3 

1 

|||||||BD 



MHH 


Ifn Logical file name 


COMMON FUNCTION 

The COMMON function enters file Ifn as a COMMON file available to any succeeding job 
after the current job terminates. 

Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 


D ^9 ^9 ^3 ^3 ^3 ^3 


B ^ IE 3 S & 3 G 3 QI 

1 

iinimi 


^ 1 ^ 1*^1 1 1 1 1 1 1 1 1 

11111111 


Ifn Logical file name 


LOCK FUNCTION 

The LOCK function sets the write lockout bit for the specified local file. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2 3 4|9j6|7|8]»|lO 

M 1I2| isj 14 1 IS 1 16 ir 

18 1 l9|2o|2l I 22|23|24|25|26| 2?! 28| 29 

30|3I |32[33[34j35[36| 


1 1 1 1 1 1 1 1 

1 1 

^1^ 1^1 1 1 1 1 1 1 

1 1 1 1 1 1 1 


Ifn Logical file name 

r If non-null, indicates recall status 


RELEASE FUNCTION 

The RELEASE function releases file Ifn according to the type specified. 
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Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 


7^7 

n j 12 jisj14115 ] 16 1 ir 



2o[2l 122j23j24| 25[26[27 j 28 

29 

3oj 3 1 1 12 


34 j35 1 36 


1 1 1 1 1 1 1 } 

R| E[ E| Aj S jE 

— 

|l|fin|, itiYiPiei, ,r 1 

1 1 1 1 1 1 J_l 


Ifn 

type 


r 


Logical file name 

Indicates the type of release. If omitted, the system assumes 
type COMMON. 


Type 

COMMON 

PRINT 

PUNCH 

PUNCHB 

P8 


Action Taken 
sets file type to local 
releases file to PRINT queue 
releases file to PUNCH queue 
releases file to PUNCHB queue 
releases file to P8 queue 


If non-null, indicates recall status 


RENAME FUNCTION 

The RENAME function replaces the name of file Ifn with the new name specified. 
Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

a|3|.l5|*|7l.|.tio 

11 j12 [ 13j 14 1 151 16 j 17 

18 1 19 

[ 2oj2l 122|23j24|25j26] 27[28j 29 

30|3l j 32 j33j 34 1 35| 36| 


1 1 1 1 1 1 1 1 

R.|E|N|A|]V^E, 


|n|,in|ap|e|,|r; , | 

III . 


Ifn Logical file name 

name New name to be given Ifn. If name is not present, the new file 
name is taken from address lfn+6 
r If non-null, indicates recall status 


REQUEST FUNCTION 

The REQUEST function displays a message which asks the operator to assign equipment to 
file Ifn. 
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Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 


IIj12 13 14 15 j16 j17 

18 j 19 j 2oj21 j 22j23|24|25|26| 27| 28 j 29 

3o]3I j 32|35|34]35|36| 


1 1 1 1 1 1 1 1 

R,E|Q|U|E|S|T 

1^ 1^ Pi 1 1 1 M 1 1 

1 1 1 1 1 1 1 J 


Ifn Logical file name 


SETID FUNCTION 

The SETID function sets the identification code for the specified file. 
Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2j3j4 5|6|7|8j9|l0 

It j 12 j isj 14115 1 16 j 17 

18 j l9|2oj21 1 22|23|24|25j26| 2?! 28j 29 

3o|3l j 32|35|34j ssjsej 



s£i£iii?Lj 

Mill 

1 1 1 1 1 1 1 1 


Ifn Logical file name 

n Identification code for file Ifn 

r If non-null, indicates recall status 

STATUS FUNCTION 

The STATUS function returns the status of the specified file. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2j3[4|5j6|7j8j9|l0 

11jI2{isj 14j15 j 16 1 17 

18 j 19 j20|2l j 22j23|24j25j26| 27 j 28| 29 

3o|3l 1 32 j35|34|35|36| 


_1_L_L_L_L_LJ_J_ 


l|f|n|.|r|a|n,d,qmj.|r 

1 1 1 1 1 1 1 J 


Ifn Logical file name 

random If random is present, the current file position is returned to (lfn+6) 
If omitted, the current status is returned in bits 0-8 of (FET) 

r If non-null, indicates recall status 
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UNLOCK FUNCTION 


The UNLOCK function clears the lockout bit for the specified file. 
Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 

BBOBBBDBQ 



B 

m 

B 

^9E9 ^SEB^SS 

B 

B 

Bl 

1 



... 1 1 1 1 1 1 1 


Ifn Logical file name 

r If non-null, indicates recall status 


TRANSFER DATA REQUESTS 

READ FUNCTION 

The READ function reads information into the circular buffer. If there is room in the 
circular buffer for at least one physical record unit, the system initiates reading and con¬ 
tinues until: 

• the buffer is full, 

• an End-of-Record or End-of-File mark appears, or 

• an End-of-Information mark appears. 


This status information is returned as follows: 

• XI contains 0 if a transfer is complete 

• XI contains -1 if an EOF mark was encountered 

• XI contains the address of the last word transferred into the working 
buffer if an EOR mark was detected before the transfer was completed 

Data is not transferred after an EOR or EOF mark is encountered. 
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Bit 1 in word 1 of the FET determines the mode. 


Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

■ 



IQ 



1 

111111111 





Ifn Logical file name 

r If non-null, indicates recall status 


RPHR FUNCTION 

The RPHR function reads the next physical record on the input device into the circular 
buffer. Bit 1 in word 1 of the FET determines the mode. 

If the physical record is too big for the circular buffer, the system writes as many words 
as possible into the buffer. 

The system returns an End-of-File response if the physical record is an EOF mark. The 
buffer will then be empty. 

Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 

BBOBBBDBB 


DBQGBSB 

S9^9S3EB^9^S 

1 

1 1 1 1 1 1 1 1 

R|P|H|R| 1 1 

1 

l|f|ni.|i^l 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


Ifn Logical file name 

r If non-null, indicates recall status 


READC FUNCTION 

With the READC function, the user can transfer one coded line from a file to a working 
buffer. The system transfers data up to the next End-of-Line mark (12-bit zero byte) or 
until the working buffer is full. When READC exits, (X7) = (B6)=last word of data transferred. 
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Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2 3[4|9|6|7 8]*|lO 

1) 1 12jisjI4|IS 1 16 IT 

la j t9|2oj2l 1 22j23|24j25j26j 2?! aaj 29 

3o|3t 1 32 jssj 341 3$! Sej 


1 1 t 1 1 1 1 1 

R|E|A)qq 1 

l|f|n| ,|b|U|f| ,| rj 1 1 1 



Ifn Logical file name 

buf Address of first working storage word to receive the coded line 

n Number of words in working storage area 


READH FUNCTION 

With the READH function, the user can transfer one coded line from a file to a working 
buffer and fill in trailing spaces. The system transfers data up to the next End-of-Line 
mark (12-bit zero byte) or until the working buffer is full. When READH exits, (X7) = (B6) = 
last word of data transferred. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

■ 

2|s|4j5j6|7|8|9jl0 

II I t2|isj 14 jIS 1 16 j 17 

ta 1 19 [ 2oj2I j 22 ! 23 j.,4j 25|26j 27 j 28 j 29 j 3o|3l 1 32|33j 34j 35 

3 


1 1 1 1 1 1 i i 

R|E|A)qH| 1 

I 

l|f|Hl »|b|Uif| ,|ni 1 1 1 1 1 1 1 1 1 1 


Ifn Logical file name 

buf Address of first working storage word to receive the coded line 

n Number of words in working storage area 


READS FUNCTION 

With the READS function, the user can transfer coded data from a file to a working string 
buffer. The system unpacks the data and stores it one character per word in the string 
buffer. Zero characters are stored as blanks (55). If the coded line terminates (12-bit 
zero byte appears) before the specified number of characters have been transferred, the 
system fills the remaining words with space codes. When READS exits, (X7) = (B6) = last 
word of data transferred. 


4-24 


59150600 Rev. A 



Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2 1 3 « 1 5 |. 1 7 [. S |l0 

It 12 13 14 IS 16 17 

18 19 20 21 22 23124 25 26 2 7 28 29|3o|3i 32 jwj 34 j 35 j 36 


-ill 1 1 11 1 

I^|E|A|D|S| 1 

1 

l|f|n|.|b|U| f|,|n| 1 1 1 1 1 1 1 1 1 1 


Ifn Logical file name 

buf Address of the first working storage word to receive the character string 

n Number of characters to be transferred 


READW FUNCTION 

With the READW function, the user can fill a working buffer from the specified file. When 
READW exits, (X7) = {B6) last word of data transferred. 

Macro format; 



LOCATION 

OPERATION 

ADDRESS 


t 

2 3 1 4 j 5 1 6 j L L 1 !0 


18 19 20 2t 22 23 24 25 26 27|2e 29 

30 31 32 33 34 35 36 


1 , , I i i 1 ; 


I|f |n|.|b|U|f|.|n) 1 1 1 

1 1 1 1 1 1 1 1 


Ifn Logical file name 

buf Base address of working buffer 

n Number of words in working buffer 


WRITE FUNCTION 

This function writes information from the circular buffer if there is sufficient information 
in the buffer to fill one or more physical record units. Writing continues until the buffer is 
empty, or the buffer contains insufficient data to fill a PRU. Bit 1 in word 1 of the FET 
determines the mode. 
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Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 

BQDBQBDBB 



B QGIESBIQ ESI 

1 

. 1 1 1 1 1 1 1 1 



miM 


Ifn Logical file name 

r If non-null, indicates recall status 


WRITER FUNCTION 

The WRITER function is like a WRITE function, except that the system writes a short or 
zero length PRU at the end of the data containing an End-of-Record mark. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

I 

2 3 4|5 |. 1 7|.|9 |lO 

ti 12jI3| 14 15 j 16 1 17 

19 j19j 20j2l j 22 ]23j24j 25[26| 27j zaj 29 

30j 3 t j 32 |35 34 35 | 36 

_ 

1 1 1 1 1 1 1 1 

■^RdlTiEiRi 

If f| ni wr.i 1 1 1 1 1 1 

1 1 1 M 1 1 1 


Ifn Logical file name 

r If non-null, indicates recall status 


WRITEF FUNCTION 

The WRITEF function directs the system to write a logical EOF mark. When the user issues 
a WRITEF function, the system first writes any data present in the buffer and terminates it 
with an EOR mark. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 


1 

23456 789 10 

It jI2[ 13 14 15 16 17 

18 19 20 2i]22j23|24 25 26 27 28 29 

30 31 32 j35 34 35 36 


1 1 1 1 1 1 1 1 


^1^1 M ^1 1 1 1 1 1 1 1 

1 1 1 M 1 1 1 


Ifn Logical file name 

r If non-null, indicates recall status 


4-26 


59150600 Rev. A 






WPHR FUNCTION 


The WPHR function directs the system to write the information in the circular buffer as a 
single PRU on the output device. Bit 1 in word 1 of the FET determines the mode. 

If the buffer contains less than one PRU, a WPHR function effects no action. 

If the buffer contains more than one PRU when the user issues this request, the system 
writes the first PRU and sets the IN and OUT pointers to show that words remain in the 
buffer. 

Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

■ 

BBDBDBaBia 

nSDDBBD 



1 


BBRHII 


hHM 


Ifn Logical file name 

r If non-null, indicates recall status 


WRITEC FUNCTION 

With the WRITEC function, the user can transfer one coded line from a working buffer to 
the specified file. The system transfers data up to the next End-of-Line mark (12-bit zero 
byte). When WRITEC exits, (X7) = (B6) = last word of data transferred. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2 3 4j5j6j7|8[9|l0 

I) j 12 I laj <4| IS 1 16 1 IT 

18 1 19 j 2o|2l j 22j 23|/4j 25|26| 27| 28 j 29 

3o|3l |32|35|34j35|36| 


1 1 1 1 1 1 1 1 

\^R|I|T^E,C, 

l|f|n| ,|b|U|f 1 1 1 1 1 

1 1 1 1 1 1 1 


Ifn Logical file name 

buf Address of first word of working storage that contains the coded line 


WRITEH FUNCTION 

With the WRITEH function, the user can delete trailing spaces and transfer one coded line 
from a working buffer to the specified file. When WRITEH exits, (X7) = (B6) = last word of 
data transferred. 
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Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 

BBOOBBDBia 

DQSDDISD 



1 

L 1 I 1 1 1 1 1 



mIMl 


Ifn Logical file name 

buf Address of first word of working storage that contains the coded line 

n Number of words in working storage area 

WRITES FUNCTION 

With the WRITES function, the user can transfer data from a working string buffer to the 
specified file. The system deletes trailing space codes and packs the characters, ten per 
word, before transferring them to the file. When WRITES exits, (X7) = (B6) = last word of 
data transferred. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 


2[3|4|5|«|t|8]9 I 10 

n 1 taj tsj ujIS 116 j 17 

18 jisjzojai j22|23|24j28j26jz7j zajas 

30|31 1 52j35|34j 35|36 


I- 1 L 1 1 11 1 

WR|I|T,E,S, 

l|f|q,|b|U|f|.|n| 1 1 1 

1 1 1 1 1 1 1 1 


Ifn Logical file name 

buf Address of first word of working string buffer that contains the coded data 

n Number of characters to be transferred 

WRITEW FUNCTION 

With the WRITEW function, the user can transfer a certain number of words from a working 
buffer to the specified file. When WRITEW exits, (X7) = (B6) = last word of data transferred. 

Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

B 



B 


1 

|B||||||B 

V^RlI|T,E,W, 

1 

I 

|f in,. |b|U|f |.|n| 1 1 1 1 1 1 1 1 1 1 


Ifn Logical file name 

buf Base address of working buffer 

n Number of words to be transferred 
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POSITION FILE REQUESTS 


SKIPF FUNCTION 

The SKIPF function directs the system to bypass one or more logical records in the forward 
direction. The user’s program can issue this request at any point in a logical record. The 
n parameter of the macro call specifies the number of logical records to skip. 

If the system finds an End-of-Information mark before it satisfies the macro request, the 
system will leave the file at the EOI mark and return EOI status. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

I 

2 3 4 5 ,|7|. , ,0 

"|'2 '3 '5 '6 17 

18 1I9|20|2l 122|23|24|25|26| 27|28|29 

30j3l 1 32|35|34|35|3€[ 


1 1 1 1 1 1 1 1 

S,K|I|Pp, , 

^|f|^l>|n|.|r| Mill 

1 1 1 1 1 1 1 1 


Ifn Logical file name 

n Number of logical records to skip; 1 < n < 777777g 

If n is null, number is assumed to be one (passed via XI) 

r If non-null, indicates recall status 


SKIPFF FUNCTION 

The SKIPFF function directs the system to bypass one or more files in the forward direction. 
The user's program can issue this request at any point in a file. The n parameter in the 
macro call specifies the number of files to skip. 

If the system finds an End-of-Information mark before it satisfies the macro request, the 
system will leave the file at the EOI mark and return EOI status. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

T' 

a 3 4 1 3 1 . 1 7 3 . ,0 

1 i 1 I2| I3| 14 IS 16 17 

18 1 I9|2o| 2( 1 22|23j24|25j26|27| 28|29 

30|3| 1 32|33|34|35|36| 


1 1 1 1 1 1 1 1 

S,K,IPP,F, 

l|f|n|,|n|,|r| , , , , 

I 1 1 1 1 1 1 1 


Ifn Logical file name 

n Number of files to skip (passed via XI) 

r If non-null, indicates recall status 
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SKIPEI FUNCTION 


The SKIPEI function directs the system to bypass, in the forward direction, all information 
in the specified file to an End-of-Information mark. 


Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

H’l-hhhlM’l'» 

II 1 I2| I3| uj IS 1 16 IT 

181 i9|2o|2l 1zajasjzA 

2S|26|27| Zsj 29| 3o|3l | 32 jssj 34 j 35 1 Ssj 


. . . 

S^l I|P,E,I, 

I 

1 1 1 1 1 1 1 L 1 [ 1 LL-J 


Ifn Logical file name 

r If non-null, indicates recall status 


BKSP FUNCTION 

The BKSP function directs the system to bypass one logical record in the reverse direction. 
The request can be issued at any point in a logical record. The system will not backspace 
past the beginning of the file. 

Macro format: 


Ifn 

r 



LOCATION 

OPERATION 

ADDRESS 

1 

i 3 4 5|e|7|.|.|,0 

II112 t3|14 IS 1 16 1 IT 

18 II9|20|2I 122|23 

24 

29|26|27| 2e| 29 

30|3i j 32[33j34j35|36| 


1 i 1 i 1 t 1 1 

^I^S|P| 1 I 

^ 1^ l^l» 1^1 1 1 1 1 1 1 1 

1 1 1 1 1 1 1 1 


Logical file name 

If non-null, indicates recall status 


BKSPRU FUNCTION 

The BKSPRU function directs the system to bypass one or more PRUs in the reverse 
direction. The request can be issued at any point in a logical record. 

If n appears, n PRUs are bypassed. If n is null, one PRU is bypassed. The system will 
not backspace past the beginning of the file. 
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Macro format: 


1 

LOCATION 

OPERATION 

ADDRESS 

■ 

BBDBODD 

BB 


m 



1 

HHHHI 

B|K|S|Pfi|U, 

i^i» 1^1 1 1 ±-lJ 

1 1 1 1 1 1 1 1 


Ifn Logical file name 

n Number of PRUs to skip; if n is null, the number is assumed to 

be one (passed via XI) 

r If non-null, indicates recall status 


SKIPB FUNCTION 

The SKIPB function directs the system to bypass one or more logical records in the reverse 
direction. The user's program can issue this request at any point in a logical record. The 
macro parameter n specifies the number of logical records to skip. If the system encoun¬ 
ters a Be ginning-of-Information mark before it satisfies the macro request, the file remains 
positioned at the Beginning-of-Information and returns Beginning-of-Information status. The 
system will not backspace past the beginning of the file. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

I 


II 1 izj laj I4| }5 1 16 1 17 

18 1 19j2o|2I 122|23 

24|25|26| 27 1 281 291 Sojsi | 32|3s|34| ssj Sej 


1 1 11 1 1 11 

SiKiipPi , 

llfini.in,. 

m 1 1 1 1 1 1 1 1 1 1 1 1 


Ifn Logical file name 

n Number of logical records to skip, 1 < n < 3777773 

If n is null, the number is assumed to be one (passed via XI) 

r If non-null, indicates recall status 


SKIPFB FUNCTION 

The SKIPFB function directs the system to bypass one or more files in the reverse direction. 
The user's program can issue this request at any point in a file. The macro parameter n 
specifies the number of files to skip. The system will not backspace past the beginning of 
the file. 
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Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2|3|4 5|6|7 8 sjlO 

II t2|i3|l4|l5 16 17 

18 1 I9|20|21 |22|23|24|25|26|27| 28| 29 



1—1 1-i 1-11 1 

S|K|I|P|F|B| 

1 1 1 1 

miM 


Ifn Logical file name 

n Number of files to skip (passed via XI) 

r If non-null, indicates recall status 


REWIND FUNCTION 

For a REWIND function, the system positions the file at the beginning of the first data record 
or at the beginning of the current reel. A REWIND function for a rewound file has no effect. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 

1 

2|s|4|5|6|7j8|9|l0 

It 1 I2| I3| I4| IS 1 16 1 17 

18 1 19|20|2I 1 22|23 

24|25|26|27| 28| 29j 3oj3l | 32 jssj 34 1 38 1 36| 


1 1 1 1 1 1 1 1 

R,E|V^I|N|D, 

I 

^ 1 1 1 1 1 1 1 1 1 1 1 1 1 1 


Ifn Logical file name 

r If non-null, indicates recall status 


UNLOAD FUNCTION 

The UNLOAD function causes the same system action as REWIND function. If the file re¬ 
sides on magnetic tape, the tape is unloaded. 

Macro format: 



LOCATION 

OPERATION 

ADDRESS 


2 3|4|5|6|7|8|9|t0 

li 1 t2| 13 I4||S 16 1 17 

18|l9|2o|2l|22|23|24|29|26|27|28|29 

BOBESDBESI 


1 1 1 1 1 1 1 1 

UiNiLiQAiD, 

1 |f ini, iri 1 1 1 1 1 1 

■BM 


Ifn Logical file name 

r If non-null, indicates recall status 
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The KRONOS Loader provides high-speed transfer from input or storage devices to central 
memory. The loader can be called by control cards or from the text of an object program. 

The loader can load and link subprograms assembled or compiled independently (in absolute 
or relocatable binary) to one another or to library subprograms. The loader issues diag¬ 
nostic messages via the dayfile and prints memory maps when requested. 

The loader can generate overlays which are written to a specified file in absolute format. 
The system then loads these overlays without the extra memory and time required to pro¬ 
cess relocation and linkage. 

These operations are governed by control cards, loader requests from object programs, 
and the standard relocatable subprogram format. 

The loader has the following features: 

1. A control card request from the user’s program initiates the loader call. 

2. Loader requests can be used to: 

• Prepare overlays and write them to a defined file 

• Load relocatable program texts 

• Load overlays 

3. The loader can load programs from more than one file (including the system 
library) for a single job. 

4. During loading, the loader links all external reference and entry points. 

5. When the loader completes loading, it fills all unsatisfied references from the 
system library, a user file, or by a diagnostic routine that traces calls to such 
references. 

6. During loading, the loader creates a memory map of all programs for which 
the user requests such a map. 

7. The loader completes loading when an EXECUTE or NOGO card appears, NOGO 
inhibits program execution and is used primarily to provide a map of the program. 
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Subsequent loading following the NOGO begins as if no programs had been loaded 
prior to the NOGO command. An EXECUTE card transfers control directly to 
the loaded programs. 

8. The loader does not prohibit loading of overlays by normal jobs, or the converse. 
However, the user must be extremely careful in the allocation of core and in com¬ 
munication between component programs. The loader also permits loading of 
absolute "original" code but complex situations can arise if it is in overlay format. 

9. The system reduces the job field length allocation for the loader when the loader 
completes loading unless a user’s request (NOREDUCE control card) prohibits this 
action. 

OVERLAYS 

The loader provides the facility to subdivide a large task into portions called overlays, and 
write them in absolute format. These overlays are then loaded at execution time without a 
relocatable loading operation. The loader generates overlays by processing control cards 
(loader directives). 

An ordered pair of octal numbers (0-77g) identifies each overlay. The ordered pair is 
written generally as (m, n). An overlay can be at one of three levels: 

• main (0, 0), 

• primary (i, 0), or 

• secondary (i, j). 

A main overlay has a designation in which m and n are zero. A primary overlay has a 
designation in which n is zero and m is non-zero. A secondary overlay has a designation 
in which both m and n are non-zero. 

Only one overlay at each level resides in central memory at one time. 

The main overlay (0, 0) can remain in memory throughout the job. Loading any other main 
overlay will destroy a previously loaded one. 

Primary overlays all begin at the same point immediately following the main overlay (0, 0). 
The loading of a primary overlay will destroy any other primary overlay. All overlays in a 
particular program must have unique identifiers. 

The origin of secondary overlays immediately follow the associated primary overlay and 
they can be loaded only by their primary overlay or by the main overlay. Loading a second¬ 
ary overlay destroys any previously loaded secondary overlay. 
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When the loader detects illegal overlays during preparation (because of erroneous identifica¬ 
tion or size), it aborts the job. 

The following diagram shows the storage allocation in core storage resulting from several 
overlay loading operations: 


Ordinal of 
Loading 
Request 

First 

Overlay 

Number 

Second 

Overlay 

Number 

Contents of User's Area After this 
Overlay has been Loaded 

1 

0 

0 

(0,0) 

Must be the first overlay 

2 

1 

0 

(0,0) 

(1,0) 



loaded 

3 

1 

1 

(0,0) 

(1,0) 

(1, 1) 




4 

1 

3 

(0,0) 

(1,0) 

(1,3) 




5 

2 

0 

(0,0) 

(2,0) 





6 

2 

2 

(0,0) 

(2,0) 

(2, 

2) 



.... 

7 

2 

1 

(0,0) 

(2,0) 

(2, 1) 


8 

4 

0 

(0,0) 

(4,0) 






LOADER DIRECTIVES 

The system interprets the following control cards as directives for loader execution. The 
user can intersperse control cards with tables but cannot intersperse them with cards 
making up a table. 


OVERLAY CARD 

Control card format: OVERLAY (Ifn, a, b, Cnnnnnn) 


Ifn Name of the file for which this overlay is to be written. The first overlay 

card must have an Ifn. Subsequent cards can omit Ifn, indicating that the 
overlays are related and are to be written in the same Ifn. A different Ifn 
on subsequent cards results in generation of overlays to the file having 
the new name. 

a First overlay number, in octal. 

b Second overlay number, in octal. 

Cnnnnnn Indicates the number (nnnnnn, in octal) of words from the start of blank 

common storage for the loader to load the designated overlay. This param¬ 
eter is optional. This feature allows the user to change the size of blank 
common storage at execution time. This parameter cannot be included in a 
main overlay directive. If this parameter is omitted, the loader uses the 
previously declared size for blank common storage. 
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OVERLAY DECKS 


The data (relocatable binary decks) immediately following the OVERLAY card up to the next 
OVERLAY card or an End-of-File mark, make up the overlay deck. When the loader has 
loaded the overlay deck, the loader satisfies the undefined external references from the sys¬ 
tem library. It writes the overlay and the overlay identification as the next logical record 
in the file. 

Each overlay has a unique entry point which is the last transfer address (XFER) that the' 
loader encounters in the overlay subprograms when it is preparing the overlay. External 
references that the loader cannot satisfy, even from the system library, result in job termi¬ 
nation after the loading operation terminates and the loader has produced maps for all of the 
overlays. The user can reference entry points in the main overlay from primary and 
secondary overlays. He can reference entry points in a primary overlay only from an 
associated secondary overlay. 


OVERLAY FORMAT 

Each overlay consists of a logical record in absolute format. The first word is the identifi¬ 
cation word. Subsequent words through end-of-logical record are data words. 


First 

word: 


59 47 41 33 17 0 


5000 

b 

a 

fwa 

ea 


a First overlay number 

b Second overlay number 

fwa First word address of the overlay (the overlay is loaded starting 
at fwa) 

ea Address of the entry point to the overlay 


MEMORY ALLOCATION 

SYSTEM 

The operating system requires storage space within the user’s declared field length in con¬ 
tiguous memory locations. It automatically assigns the first lOOg locations: 
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RA 

RA+ 1 
RA+ 2 


59 53 


32 


23 


RA + 63 
RA + 64 

RA+ 65 
RA+ 66 

RA + 67 
RA+ 70 

RA+ 77 


Reserved for Use During Execution 


Parameters from the Program Call Card 
(Available to User During Execution) 



Image of Card which Calls for 
Program Execution 


Parameter 

Bit 

Description 

f 

32 

No Reduce FL bit; set if loader is not to reduce field 

length for the job. 

P 

31 

Partial map bit; set if loader is to output a single 

line header instead of a complete map. 

e 

29 

End-of-load bit; set if LDR has completed the re¬ 
quested load. 

n 

28 

NOMAP flag; set if the loader is not to output a 

memory map. 

r 

27 

RSS bit; set if operation is in RSS mode. 

c 

24-26 

Code indicates last control card interpreted: 


000 program call card 

001 LOAD card 

010 EXECUTE card 

100 NOGO card 


The system establishes loader tables at the high end of the user’s field length. The user 
must provide space for the loader and the loader tables in his field length declaration. Blank 
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common can overlay the loader tables. Conversely, if the user calls the loader again, 
they can overlay blank common. The user must assure that his field length is long enough 
to accommodate the loader tables and blank common if he wishes to preserve his data. 

The system cannot guarantee that the applications program cannot destroy the loader tables. 


USER 

The loader assigns memory to subprograms and associated labeled common blocks as it 
encounters them. The loader preserves blank common relocation information until it has 
completed loading, at which time it allocates blank common following the last loaded pro¬ 
gram or labeled common block. 

Declarations of blank common vary between subprograms, but the largest declaration 
determines the actual allocation. 

MEMORY MAP 

Following completion of the loading, the loader can produce a map of the user’s area in the 
OUTPUT file. The map includes: 

• Total length of all loaded programs and common blocks 

• Length of the loader and its tables 

• Names and locations of programs loaded, and the name of the file 
from which they are loaded 

• Names and locations of common blocks 

• Names and locations of entry points with a sublist of all programs 
referencing the entry point 

• Unsatisfied external references 

During generation of an overlay, the loader provides the record of a new overlay each time 
a call is made to the CPU loader program. The user can suppress the generation of this 
map by setting the NOMAP bit in the loader parameters to one. 
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This section illustrates sample decks for: 

• COMPASS language programs 

• FORTRAN language programs 

A card with a 7-8-9 punch in column 1 separates logical records. A card with a 6-7-9 
punch in column 1 separates files. A card with a 6-7-8-9 punch in column 1 marks the 
End-of-Information. Figure 6-1 shows a basic job deck. 


DATA 


(I 

^ END - OF - INFORMATION 
8 


RECORD 


PROGRAM 

RECORD 


CONTROL 

CARD 

RECORD 


8 RECORD SEPARATOR 

9 




8 RECORD SEPARATOR 

9 


/ ACCOUNT CARD 



Figure 6-1. Basic Job Deck 
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COMPASS DECKS 

Figures 6-2 and 6-3 illustrate typical COMPASS language decks. Figure 6-2 shows a deck 
for KRONOS to assemble with listing and binary output, and execute the subprogram using 
the included input data. 



Figure 6-2. COMPASS Assemble and Execute Deck 
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Figure 6-3 shows a deck for KRONOS to assemble with listing and binary output, punch the 
binary output, and execute the first program. 



Figure 6-3. COMPASS Assemble, Execute and Punch Binary Output Deck 
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FORTRAN DECKS 


Figures 6-4 through 6-6 illustrate various structures of FORTRAN language decks. These 
decks have various requirements for computation, user output, and overlay preparation. 


DATA 

RECORD 


PROGRAM 

RECORD 


CONTROL 

CARD 

RECORD 


8 

9 




RUN ( G, 20000) 


/account, ABCDEFG, TUVWXYZ. 
/mother^ PIO, TIOOO , CM60000. 


DATA CARDS 

_L 


T 


SOURCE CARDS 


Figure 6-4. FORTRAN Compile and Execute Deck 
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Figure 6-5. FORTRAN Load and Run Deck 
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6 



Figure 6-6. FORTRAN Overlay Preparation Deck 
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The KRONOS library contains a set of PPU and CPU utility programs which the user can 
call with control cards. The system provides for card-to-tape, tape~to-tape, tape-to- 
print, card-to-central storage, central storage-to-punch, file editing, and general file 
manipulation operations. KRONOS performs utility operations on named files, each of 
which designates a specific peripheral device such as a card reader, tape unit, printer, 
card punch, or disk. 

Before the first reference to any named file, the operator assigns a device to it with the 
ASSIGN command in response to a REQUEST control card, or by an ASSIGN card; otherwise, 
the system assigns the file to a disk unit. All files, except those on disk, specify a unique 
peripheral device and all references to the specific device are made through the file name. 

Utility jobs conform to the normal deck structure (Section 6). If the user has only utility 
programs to run, the job card can specify a short field length. In all copy operations, the 
system automatically sets up the central memory buffer to use the entire field length of the 
job. Some operations between high-speed devices run faster with a large buffer. 

The user’s program should request the operator to assign equipment to all necessary files 
which do not reside on the disk. The system will rewind and position tapes upon request. 

The user can call each utility program by specifying its name, starting in column 1. Param¬ 
eters for execution of the program appear in parentheses after the name. 


LIBRARY ROUTINES 

GENERATE USER LIBRARY FILE (LIBGEN) 

Control card format: LIBGEN (L=library, N=name, I=input) 

library Name of library file; if undefined, the system assumes LIBRARY 

(file is not rewound). 

name Name of file identifier; this parameter is necessary if the user 

library file is to reside on the system library tape. If undefined, 
the system assumes ULIB. 

input Name of file containing input data; if undefined, system assumes 

LGO (file is rewound). 
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With the LIBGEN card, a user can generate a library file. The input file supplies the sub¬ 
programs to be included in the file. 

LIBGEN reads the input file and creates a directory of entry points. When a zero-length 
record or End-of-File mark appears, LIBGEN terminates the directory and rewinds the 
input file. LIBGEN then writes the directory and copies the input file to the library file. 

A zero-length record followed by a file mark terminates the library file. 


EDIT USER LIBRARY FILE (LIBEDIT) 

Control card format: LIBEDIT (p^, p^, . . . , p^^) 


Pi 


Parameters; can be any of the following in any order: 


Option 
I = 0 

I = fname 


Specify 

Use no correction file input 

Use file fname for correction file input 


OLD = 0 
OLD = fname 


Use no old file 

Use file fname for old file 


NEW = fname 


Use file fname for new file 


L - 0 
L = 1 


Print no correction listing 
Print only the changes made 


LO = fname 


Use file fname as output file 


LGO = 0 
LGO = fname 
C 
V 
R 


Generate no default correction file 
Use file fname for default correction file 
Copy file NEW to OLD 
Verify files OLD and NEW 
Do not rewind OLD and NEW 


By calling the LIBEDIT utility program, the user can edit a library file. Specific LIBEDIT 
directives, which appear in the program record, include: 


^INSERT 

DELETE 

^IGNORE 


^RENAME 
^i^RE PLACE 
>5= COPY 
BE FORE 


See the KRONOS external documentation for the current capabilities of these directives. 
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CONVERT UPDATE LIBRARY TO MODIFY LIBRARY (UPMOD) 

Control card format: UPMOD P 2 , . . . , p^^) 


Parameters; 

can be any of the following in any order: 

Option 

Specify 

P 

P = fname 

UPDATE program library is on file OLDPL 
UPDATE program library is on file fname 

N 

N = fname 

MODIFY program library is on file OPL 
MODIFY program library is on file fname 

M 

M = fname 

MODIFY program library name is OPL 
MODIFY program library name is fname 

F 

F=x 

Convert to file mark 


The UPMOD utility program converts program libraries that have been maintained by UP¬ 
DATE to program libraries that can be maintained by MODIFY. Unless the F option is 
selected, UPMOD converts one logical record. For parameters omitted from the control 
card, the system assumes: 

P - OLDPL 
N - OPL 
M= OPL 


CATALOG FILE SET (CATALOG) 

Control card format: CATALOG (files, N=n, L=list) 

files Name of file set to be cataloged 

n Number of files to catalog; if n=0, all files are cataloged until 

an empty file is found 

list Name of file to receive catalog information 

The CATALOG card lists catalog information on file "catalog" for n files of the file set. 
For each file, CATALOG lists the: 


• 

file name. 

• 

record type. 

• 

current file number. 

• 

record length, and 

• 

record number. 

• 

checksums for the records. 

The listing for each file begins 

on a new page. 
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COMPARE RECORDS (VERIFY) 

Control card format: VERIFY (file^, file 2 , P 2 > • • • , Pj^) 


file^ 

file2 

Pi 


Name of first file; if omitted, the system assumes TAPEl, 


Name of second file; if omitted, the system assumes TAPE2. 
Parameters; can be any of the following: 

Option Specify 

N = X Verify x files. If x = 0, terminate operation on the 

first empty file from either medium. If N is omitted, 
the system assumes N = 1. 


E = X 


List first x errors in comparison; if omitted, the 
system assumes E = 100. 


L = fname List output on file fname; if omitted, the system 
as sumes L=OUT PUT. 


A 


Abort if errors occur. If omitted, the system will 
not abort. 


The VERIFY program compares data on two files, word for word, in Binary mode. When- 
ever words on the two files do not match, VERIFY lists: 

• the record number, 

• the word number within the record, and 

• the words from both media that do not match. 

The E option can save the system much wasted effort if the files are drastically dissimilar. 


COMPARE LIBRARY FILES (VFYLIB) 

Control card format: VFYLIB (old, new, output, r) 

old Name of old library file; if omitted, the system assumes OLD 

new Name of new library file; if omitted, the system assumes NEW 

output Name of file to receive output; if omitted, the system assumes OUTPUT 

r If set, old and new are not rewound. 

The VFYLIB program compares an old library file with a new one and lists: 

• replacements, • insertions, and 

• deletions, • changes in residence 

on the output file. 
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EXTRACT EXTERNAL DOCUMENTATION (DOCEXT) 

Control card format: DOCEXT (sfile, ifile) 

sfile Name of program source file; if omitted, the system assumes COMPILE 

ifile Name of file on which to list documentation; if omitted, the system 

assumes OUTPUT 

The DOCEXT program extracts the external documentation — the lines that begin with three 
asterisks and all contiguous comment lines — from the source file and lists the documenta¬ 
tion on the output file. 


GENERATE SYSTEM SYMBOL CROSS REFERENCE (SYSREF) 

Control card format: SYSREF (p-, p.., . . , ,p ) 

X ^ n 


Pi 


Parameters; can be any of the following: 


Option 


Specify 


P 

P = fname 
L 

L = fname 
S 

S = fname 


Old program library input from file OPL, 

Old program library input from file fname 

List output on file OUTPUT 

List output on file fname 

System text from overlay SYSTEXT 

System text from overlay fname 


The SYSREF program generates a cross reference list of system symbols used by decks on 
a specified old program library file. 


COPY ROUTINES 

COPY THROUGH EMPTY FILE (COPY) 

Control card format: COPY (file^, file 2 , x) 

file^ Name of file to copy from 

file 2 Name of file to receive copy 

X If present, rewind and verify both files 

The COPY routine copies fileto file 2 through an empty file in file^^. It then backspaces 
file2 over the last file mark. If the file names are omitted, the system assumes INPUT, 
OUTPUT. 

This routine can be used to copy a tape even if the number of files on the tape is not known, 
providing the tape terminates with an empty file. 
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COPY BINARY FILE (COPYBF) 

Control card format: COPYBF file 2 , n) 

file^ Name of file to copy from 

file 2 Name of file to receive copy 

n Number (decimal) of binary files to copy; if absent, the system 

assumes n=l 

The COPYBF routine copies n binary files from file^^ to file 2 . If the first and second 
parameters are omitted, the system assumes INPUT, OUTPUT. 

COPY BINARY RECORD (COPYBR) 

Control card format: COPYBR (file^, file 2 , n) 

file^ Name of file to copy from 

file 2 Name of file to receive copy 

n Number (decimal) of binary records to copy; if absent, the system 

assumes n=l 

The COPYBR routine copies n binary records from file^ to file 2 . If the first and second 
parameters are omitted, the system assumes INPUT, OUTPUT. 

The COPYBR operation terminates when COPYBR has read the required number of records (n). 

COPY CODED FILE (COPYCF) 

Control card format: COPYCF (filep file 2 , n, fchar, ichar) 
file^^ Name of file to copy from 

file 2 Name of file to receive copy 

n Number (decimal) of BCD files to copy; if absent, the system assumes n=l 

fchar First character of each line to copy; if omitted, the system assumes fchar = 1 

ichar Last character of each line to copy; if omitted, the system assumes ichar = i36 

The COPYCF routine copies n coded (BCD) files from file^ to file 2 . If the first and second 
parameters are omitted, the system assumes INPUT, OUTPUT. If the first and second 
parameters are the same, the system skips n files. 
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COPY CODED RECORD (COPYCR) 

Control card format: COPYCR (file^, file 2 , n, fchar, ichar) 

file^ Name of file to copy from 

file 2 Name of file to receive copy 

n Number (decimal) of coded records to copy; if absent, the system assumes 

n = 1 

fchar First character of each line to copy; if omitted, the system assumes 

fchar = 1 

fchar Last character of each line to copy; it omitted, the system assumes 

fchar = 136 

The COPYCR routine copies n logical records from filei to file 2 . If the first and second 
parameters are omitted, the system assumes INPUT, OUTPUT. If the first and second 
parameters are the same, the system skips n records. 

The COPYCR operation terminates when COPYCR has read the required number of records 
(n). 


COPY SHIFTED BINARY FILE (COPYSBF) 

Control card format: COPYSBF (file^, file 2 , n) 

filcj^ Name of file to copy from 

file 2 Name of file to receive copy 

n Number (decimal) of coded records to copy; if absent, the system assumes 

n = 1 

The COPYSBF routine copies n files of coded information from filej^ to file 2 , shifting each 
line one character and adding a leading space. If the parameters are omitted, the system 
assumes INPUT, OUTPUT, 1. 

This routine is used to format a print file where the first character of each line is not a 
control character and is to be printed. The added space character results in single line 
spacing and a page eject at the beginning of each record when the system prints the file. 
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COPY TO TERMINATOR (COPYX) 

Control card format: COPYX file 2 , term, bksp) 

file^ Name of file to copy from; if undefined, system assumes INPUT 

file 2 Name of file to receive copy; if undefined, system assumes OUTPUT 

term Terminator type: 

term = n; copy n records 

term = 00; copy to zero-length record 

term = cccccc; copy until record named cccccc appears 
If term is undefined, the system assumes term = 1 

bksp Backspace command: 

bksp = 0; no backspace 
bksp = 1; backspace file^ 
bksp = 2; backspace file 2 
bksp = 3; backspace both files 
If bksp is undefined, the system assumes bksp = 0 

COPYX copies binary records to the specified terminator and then backspaces the file or 
files according to the parameters given. 


FILE MANIPULATION ROUTINES 

UNLOAD FILE (UNLOAD) 

Control card format: UNLOAD (file 2 , file 2 , . . . , 

The UNLOAD routine rewinds and unloads file^ • • • > does not dissociate 

the files from the control point. 

REWIND FILE (REWIND) 

Control card format: REWIND (file^, file 2 , • . . , 

The REWIND routine rewinds file^, file 2 , . . . , 
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SKIP TO END-OF-INFORMATION (SKIPEI) 

Control card format: SKIPEI (file^) 

file^ Name of the file to be positioned; if omitted, the system assumes FILE. 

The SKIPEI card directs the system to reposition file^ to the End-of-Information symbol. 
This card can only be used with mass storage devices. 


SKIP FILE FORWARD (SKIPF) 

Control card format: SKIPF (file^, n) 

file^ Name of file set to be positioned; if omitted, the system assumes FILE 

n Number (decimal) of files to skip; if omitted the system assumes n = 1 

The SKIPF card directs the system to bypass one or more files, in the forward direction 
to file;!^. 

SKIP FILE BACKWARD (SKIPFB) 

Control card format: SKIPFB (filCp n) 

file^ Name of file set to be positioned; if omitted, the system assumes FILE 

n Number (decimal) of files to skip; if omitted, the system assumes n=l 

The SKIPFB card directs the system to bypass one or more files, in the reverse direction, 
to file^. 

SKIP RECORD FORWARD (SKIPR) 

Control card format: SKIPR (file^, n) 

file^ Name of file to be positioned; if omitted, the system assumes FILE 

n Number (decimal) of logical records to skip; if omitted, the system 

assumes n=l 

The SKIPR card directs the system to position file^ forward n logical records. 
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BACKSPACE LOGICAL RECORDS |BKSP) 

Control card format: BKSP (file^, n) 

file^ Name of file to be backspaced; if omitted, the system assumes FILE 

n Number (decimal) of logical records to backspace; if omitted, the 

system assumes n=l 

The BKSP routine backspaces n logical records. Backspacing terminates if file^ 

becomes rewound. 


RETURN FILES (RETURN) 

Control card format: RETURN (file^, file 2 , . . . , 
file^ Names of files to be returned 

The RETURN card returns files to the system. If a file named is a COMMON file on which 
the system allows other than read operations, it becomes available to other users. Other¬ 
wise, the system disposes of the files according to file types. 


INPUT/OUTPUT ROUTINES 

LOAD BINARY CORRECTIONS (LBC) 

Control card format: LBC, addr. or 

LBC. 

addr Address (octal) relative to RA at which binary load begins; if absent, 

LBC begins at RA 

The user can call the LBC peripheral program with a control card. LBC reads binary 
corrections from the INPUT file and enters them in central storage. If addr is specified 
in the program call, binary cards are loaded beginning with that address; otherwise, load¬ 
ing begins at the reference address. LBC reads only one record from the INPUT file. The 
user must make an LBC call for each record of data to be loaded. This program is intended 
for loading cards punched by the PBC routine. 
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LOAD OCTAL CORRECTIONS (LOC) 

Control card format: LOC (fwa, Iwa) or 

LOC (Iwa) or 

LOC. 


fwa Address (octal) relative to RA at which octal load begins; if absent, LOC 

begins at RA 

Iwa Last word address plus one (octal) of the buffer area in which to load octal 

cards; if absent, LOC reads all correction cards in the next INPUT file 
record 

The user can call the LOC peripheral program with a control card. LOC reads octal 
corrections from the INPUT file and enters them in central storage. The octal correction 
cards must be in the following format: 


1 7 


23001 


45020 


04000 00042 


00044 


Address begins in column 1; leading zeros can be omitted. The data word begins in column 
7; spacing in the data word is not important but the word must contain 20 digits. 

PUNCH BINARY CARDS (PBC) 

Control card format: PBC (fwa, Iwa) or 

PBC (Iwa) or 

PBC. 

fwa Address (octal) relative to RA at which the binary deck begins; if absent, 

PBC uses RA 

Iwa Last word address plus one (octal) of the binary deck; if absent, RA con¬ 

tains the number of words in the lower 18 bits 

The PBC routine punches a deck of binary cards directly from central memory and does 
not modify central memory. 


READ BINARY RECORD (RBRj 

Control card format: RBR, n. 

n Specifies fifth character of file name (1-7); first four characters are TAPE 
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The RBR routine loads one binary record from the file specified by the user. Loading begins 
at RA. RBR uses central memory locations FL-5 through FL-1 for buffer parameters and 
destroys the original contents of these locations. 


WRITE BINARY RECORD (WBR) 

Control card format: WBR, n.rl. 

n Specifies fifth character of file name (1-7); first four characters are TAPE 

rl Record length in words; if absent, length is taken from the lower 18 bits 

of RA 

The WBR routine writes a binary record from central memory to the file specified by the 
user. WBR begins writing from RA. WBR uses central memory locations FL-5 through 
FL-1 for buffer parameters and destroys the original contents of these locations. 

Example: 

To write a program on tape after patching it: 

REQUEST TAPE5. 

REQUEST TAPE2. 

REWIND (TAPE5). 

REWIND (TAPE2). 

RBR, 5. 

LOG. 

WBR, 2. 

WRITE FILE MARKS (WRITER) 

Control card format: WRITEF (file^, n) 

file^ Specifies the file to be written on 

n Number of file marks; if omitted, the system assumes n=l 

The WRITEF card instructs the system to write n file marks on a file. 


WRITE EMPTY RECORDS (WRITER) 

Control card format: WRITER (file^, n) 

file^ Specifies the file to be written on 

n Number of blank records; if omitted, the system assumes n=l 
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The WRITER card instructs the system to write n empty records on a file. 

REQUEST FIELD LENGTH (RFL) 

Control card format: RFL, nfl 

nfl New field length (octal) 

The RFL routine changes the field length for the execution of a program. This routine is 
also used internally by the RUN compiler. For a short 5000g word program, storage would 
be used most efficiently by calling RFL. 

DUMP STORAGE (DMP) 

Control card format: DMP (fwa, Iwa) or 

DMP (Iwa) or 

DMP. 

First word address of memory to be dumped; if five digits are prefixed 
by a 4, fwa is absolute first word address; otherwise, fwa is relative to 
RA. If fwa is absent. Dump mode depends on the presence or absence of 
Iwa 

Last word address plus one of memory to be dumped; if five digits are pre¬ 
fixed by a 4, Iwa is absolute last word address plus one; otherwise, Iwa is 
relative to RA. If Iwa alone is present, DMP assumes fwa = RA. If neither 
fwa or Iwa is present, DMP dumps the exchange package and 100 locations 
before and after the stop location 

The user can call the DMP peripheral program with a control card. The DMP routine 
dumps central memory according to the DMP call parameters. 


fwa 


Iwa 
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I/O CODES 


Code 

Macro 

Order 

00 

RPHR 

Read one PRU from file 

04 

WPHR 

Write one PRU to file 

10 

READ 

Read to CM 

14 

WRITE 

Write until short PRU 

24 

WRITER 

Write to End-of-Record 

30 

SKIPFF 

Skip forward n logical files 

34 

WRITE 

Write a file mark 

40 

BKSP 

Backspace one logical record 

44 

BKSPRU 

Backspace n logical PRUs 

50 

REWIND 

Rewind file 

60 

UNLOAD 

Unload tape file 

70 

RETURN 

Return file to system 

114 

EVICT 

Release allocatable storage 

130 

SKIPFB 

Skip backwards n logical files 

200 

— 

Read to End-of-Information 

240 

SKIPF 

Skip forward n logical records 

640 

SKIPB 

Skip backwards n logical 
records 
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RELOCATABLE SUBROUTINE FORMATS 


B 


In order to be externally compatible with SCOPE versions of COMPASS and other language 
translators, KRONOS subscribes to the SCOPE relocatable subroutine format. Hence, the 
logical record of output (subroutine) consists of an indefinite number of tables. Each table 
in this appendix is a subdivision of a logical record. 


IDENTIFICATION WORD 

The first word of each table identifies the table to the system. That is, it indicates the kind 
of information that the table contains. The format of the identification word is: 


59 53 47 35 26 17 0 

- W/Z/yf/A -P7777777777I- 1 1 



Y/////A 

V///////// 



cn 

words 


reloc 

address 


The parameters of the identification word are: 


TABLE B-1. IDENTIFICATION WORD PARAMETERS 


Code Number 
(cn) 

Table 

reloc 

address 

words 

34 

Program 
Identification 
and Length 

not used 

0 

Number of words 
in table (not count¬ 
ing identification 
word) 

36 

Entry Point 

not used 

not used 


40 

Text 

reloc=0, relative to RA 

reloc = 1, relative to pro¬ 
gram origin 

reloc = 3-773, relative to 
labeled common 
block M, where 
M is in position 
LR-2 of LCT 

load 

address 


42 

Fill 

0 

0 


43 

Replication 

not used 

not used 


44 

Link 

not used 

0 


46 

Transfer 

not used 

not used 


77 

Prefix 

not used 

1 not used 



59150600 Rev. A 


B-1 




PROGRAM IDENTIFICATION AND LENGTH (PIDL) TABLE 



59 

17 

0 

word 1 


name of subprogram pi 


name 

pi 

of subprogram 

May be 7 display code blank characters 
Program length 



59 

17 

0 

words 2 - 

wc 

name of common block bl 


wc 


Word count 



name of common block May be 7 display code blank characters 
bl Block length 

If wc = 1, no common references appear in the program. The subprogram length is relevant 
only in the first Program Identification and Length Table. All PIDL tables must appear 
prior to the display of any other tables associated with a given subprogram. The names of 
common blocks cannot be duplicated in a PIDL table. The list of common block names is 
called the Local Common Table (LCT). Since the relocation of addresses relative to com¬ 
mon blocks is designated by the positions in the LCT, the order of the common block names 
is significant. (The first word in the LCT is referred to as position 1.) 

ENTRY POINT (ENTR) TABLE 

The Entry Point (ENTR) Table contains the names of the entry points to the subprogram 
and its associated labeled common blocks. The ENTR Table must immediately follow the 
PIDL tables. 

59 26 17 0 

words 1 - wc 

rl Relocation of the address specified by LOC 

0 absolute, relative to RA (no relocation) 

1 program address 

3-770 relative to common block M, where M is in position rl-2 of LCT 
(M must not refer to blank common) 

loc Address of data word to be modified 
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TEXT TABLES 


Text tables, which can appear in any order and any number, contain subprogram data and 
relocation information for the data. Each table includes an origin for the data, the data 
itself, and relocation indicators. 

The relocation word (first word), which is a series of 4-bit bytes, describes relocation of 
the three possible memory address references in a 60-bit data word. Relocation is deter¬ 
mined relative to either the program origin or the complement of the program origin (nega¬ 
tive relocation). The value and relocation for each byte is as follows: 


ooox 

no relocation 


lOXX 

upper address. 

program relocation 

IIXX 

upper address. 

negative relocation 

OlOX 

middle address 

, program relocation 

OllX 

middle address, 

, negative relocation 

1X10 

lower address. 

program relocation 

1X11 

lower address. 

negative relocation 

0010 

same as 1X10 


0011 

same as 1X11 



These designations permit independent and simultaneous relocation of both upper and lower 
addresses. 

Data words (words 2-wc, wc < 2 O 3 ) are loaded consecutively beginning at the load address 
L, and their addresses are relocated as specified by the corresponding byte in the reloca¬ 
tion word. 

All addresses are relocated absolutely or relative to the program origin. They are never 
relocated relative to a labeled common block. 


FILL TABLE 

Words 1-wc are partitioned into sets of 30-bit contiguous bytes consisting of one control 
byte followed by an indefinite number of data bytes. The last byte can be zero. The con¬ 
trol byte holds information concerning each of the subsequent data bytes until another 
control byte is encountered. 
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A zero byte is treated as a control byte in the format: 



ar Relocation of the value in address position of word specified 

in succeeding data bytes: 

0 absolute, relative to RA (no relocation) 

1 program relocation 

2 negative relocation 

3‘77g relative to common block M, where M is in position 
ar-2 of LCT 

The data byte format is: 



p Position within word of address specified by rl and loc 


10 

upper 

01 

middle 

00 

lower 


rl Relocation of address specified by loc 

loc Address of data word to be modified 

LINK TABLE 

Word format: 



Names of external symbols (7 characters) must begin with a character for which the display 
code representation has a high order bit equal to zero. The data bytes have the form: 



p Position within the word of the reference to the external symbol: 


10 

upper 

01 

middle 

00 

lower 
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rl Relocation of address specified by loc 

0 absolute, relative to RA 

1 program relocation 

3-77o relative to common block M where M is in position 
rl-2 of LCT 

loc Address of the word containing the reference to the external symbol 


REPLICATION TABLE 

Each entry in the Replication Table is in the following format: 


59 41 26 17 _0 


i 

sr 

s 

c 

b 

dr 

d 


i Increment d by this value before each data block is repeated; first 

repetition of block is at d, second at d+1, etc. The data block (B- 
long) with origin at s is repeated c times beginning at d the first 
time, and beginning at the previous origin plus i thereafter. If i = 0, 
i is interpreted as b. 

sr Relocation of the address specified by s: 

0 absolute, relative to RA 

1 program relocation 

3“77g relative to common block M where M is in position sr-2 
of LCT; must not refer to blank common 

s Initial address of the source data; must be non-zero 

c Number of times data block is to be repeated; if c = 0, c is interpreted as 

b Size of data block; if b=0, b is interpreted as 1 

dr Relocation of address specified by d 

d Initial address for destination of data; if d = 0, d is interpreted as s+b 


TRANSFER TABLE 


Each entry in the Transfer Table is in the following format: 

59_ 17 0 

entry point name 

This table indicates the end of a subroutine and a pointer address. The entry point name 
need not be in the subprogram. If name is blank, there is no named transfer. 
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CARD FORMAT 



COLUMN 1 

Column 1 indicates the kind of data 

Punch 
V, 8, 9 
6, 7, 9 

5, 7, 9 

6, 7, 8, 9 

7, 9 

Not 7 and 9 


that might appear on a card: 

Represents 
End-of-Record mark 
End-of-File mark 
Change code conversion 
End-of-Information mark 
Binary card 
Coded card 


COLUMNS 



BINARY CARD 

A binary card can contain up to 15 central memory words of data starting with column 3. 
Column 1 also contains a central memory word count in rows 0, 1, 2, and 3 plus a checksum 
indicator in row 4. If row 4 of column 1 is unpunched, column 2 can be used as a checksum 
for the card. If row 4 is punched, column 2 is not an accurate checksum for the card. 
Column 78 is blank. Columns 79 and 80 contain the card sequence number in binary. 
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CODED CARDS 

Coded cards are in Hollerith code of up to 80 characters per card. When the system reads 
coded cards, it converts the data to display code and packs it 10 columns per CM word and 
deletes trailing blanks*. Code conversion can be specified. 

When the system punches coded cards, it extracts data from a line to an End-of-File mark 
or to the 80th character converting from display code to Hollerith. 


C-2 


59150600 Rev. A 



ERROR DIAGNOSTIC MESSAGES 


D 


Message 
ARITH. ERROR. 

CHARACTER LIMIT ERROR. 

CLL. ARC. ERROR, xxxxxx. 


CLO ARC. ERROR. 

CPxx. COMPARE ERROR. 

CRxx, BINARY CARD ERROR. 

DISK X PARITY ERROR 
"^yyy Gz Swww. 

DMP ARG. ERROR. 

DRUM X PARITY ERROR 
Uy Gzz Awwwww. 

ECS ABORT Axxxxxxx. 

END OF FILE. 

EQxx TRACK LIMIT. 

ERROR IN ARGUMENTS. 


Explanation 

The system monitor has detected an arithmetic error 
condition in the last executing CPU program. 

The number of the first character to copy cannot be 
greater than the number of the last character; nor can 
the last character number be greater than 150. 

The argument xxxxxx is (a) equal to or greater than the 
field length minus two, or (b) the upper address of the 
argument is equal to or greater than the field length, or 
(c) the first address is equal to or greater than the 
upper boundary address. 

The CLO argument address is greater than or equal to 
the field length. 

Card punch xx has mispunched a card. Operator action 
is not required since the card punch offsets the bad card 
and the card following it, and repunches both of these 
cards. 

The card reader xx has detected a binary checksum 
error on the last card read. 

While loading from the disk, a 6603 or 6638 driver has 
detected an unrecoverable parity error on disk x, track 
yyy> group z, and sector www. 

The user has requested a dump of an area in central 
memory, the limits of which are outside the user field 
length. 

A 3436/863 driver has detected an unrecoverable parity 
error on unit y, of drum system x, at address wwwww, 
of head group zz. 

An ECS abort occurred while a program was referenc¬ 
ing the data beginning at address xxxxxxx. 

An End-of-File mark was found before a copy operation 
was complete. 

All tracks on device xx are reserved. Hence, none are 
available for processing of the user file. 

Check the control card syntax as described in Sections 3 
and 7. 
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Message 


Explanation 


FATAL LOAD ERROR xx. KRONOS has detected a fatal load error, number xx, dur¬ 

ing the current load operation. The system aborts the job. 

ffffffNOT ON SYSTEM. File ffffff does not reside on the system mass storage 

device. 

FILE ALREADY ASSIGNED. The control statement has requested a file which is 

already assigned to the job. 

FILE NAME CONFLICT. Check the preceding control card. Two names are 

identical which KRONOS does not allow. 

FILE NAME IN USE. The file name on a COMMON or RESERVE request is 

currently used by a COMMON file. 

FILE NOT CREATED. A control statement has attempted to declare a non¬ 

existent file as COMMON. 

FILE NOT IN MASS The file requested for program execution does not re- 

STORAGE. side on a mass storage device. 

FILE PROTECTED. An attempt was made to release a’Vead only” file. 

FL TOO SHORT FOR Provide at least 6,200g locations for the CATALOG 

CATALOG. program. 

FL TOO SHORT FOR COPY. Provide at least 4,6000g locations for the COPY 

operation. 

FL TOO SHORT FOR DOCEXT. Provide at least 6,2008 locations for the DOCEXT 

program. 

FL TOO SHORT FOR LOADER. There is not enough memory space in the user’s field 

length for LOADER. 

FL TOO SHORT FOR MODIFY. Provide at least 24, OOOg locations for MODIFY opera¬ 
tions . 

FL TOO SHORT FOR VERIFY. Provide at least 6, 3008 locations for the VERIFY pro¬ 
gram. 

FORMAT ERROR ON A system routine has found a format error on a control 

CONTROL CARD. card. The bad card precedes this message in the dayfile. 

ILLEGAL CHARACTER The character count on a control card must be a numeric 

NUMBER. character. 

ILLEGAL CONTROL CARD. The control statement could not be identified. 

ILLEGAL EQUIPMENT. A control card has attempted to assign or request a 

non-existent peripheral device to a user file. 

ILLEGAL FILE COUNT. The file count on a control card must be a numeric 

character, 

ILLEGAL PRIORITY. Do not request a priority of less than one or greater 

than 17. 
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Message 


Explanation 


ILLEGAL RECORD COUNT. 

ILLEGAL RECORD FORMAT. 

IMPROPER PACKAGE 
LABEL. 

INVALID PARAMETER IN 
PROGRAM. 

JOB CARD ERROR. 

LBC ARC. ERROR. 

LIBRARY OVERFLOW. 

LOADER NOT IN LIBRARY. 

LOADER TEXT BAD. 

LOC ARG. ERROR. 


MSG ARG. ERROR. 

MTxx, READ PARITY 
ERROR. 

MTxx, WPE RECOVERED. 
MTxx, WPE UNRECOVERED. 

NO DATA IN FILE. 

OPE ARG. ERROR 


The record count on a control card must be a numeric 
character. 

Records on the source file from which to generate user 
libraries must be in relocatable form. 

The called PPU package name is in improper format 
for insertion in RPL. 

An illegal call to the ALGOL routine finder (ALG) has 
been generated. 

KRONOS has detected an error on a job card. 

The LBC argument address is greater than the field 
length. 

The system cannot make another entry in the library 
directory. 

A program has written other information in the system 
library area and destroyed the loader. 

The routine LOD was unable to properly load the 
system loader. 

In an attempt to load octal corrections to central mem¬ 
ory, the operator has done one of two things: 

a. addressed an area outside his field length, or 

b. his FIRST address is greater than his LIMIT 
address. 

A dayfile message specifies an address that is greater 
than or equal to the field length of the user's control 
point. 

The system has detected a parity error after eight re¬ 
read attempts. The operator should either type n.GO 
(in which case the record containing the parity error is 
lost) or type n. DROP. 

The system has recovered a write parity error located 
on magnetic tape unit xx. The job continues. 

The system has not recovered a write parity error 
(located on magnetic tape unit xx) after eight rewrite 
attempts and one Skip Bad Spot function. The operator 
should type either n.GO or n. DROP. 

The file requested for execution contains no data. 

The address of the File Environment Table in the call 
to Open File Routine (OPE) is greater than or equal to 
the FET field length minus five. 
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Message 


Explanation 


OPERATOR DROP. 

PBC ARG. ERROR. 

PBC RANGE ERROR. 

PP CALL ERROR. 

PROGRAM NOT 
AVAILABLE. 

PROGRAM NOT ON MASS 
STORAGE. 

PROGRAM TOO LONG. 

RBR ARG. ERROR. 

RECORD LENGTH TOO 
LONG. 

RECORD TOO LONG. 

REQ ARG. ERROR. 

REQ. ILLEGAL EQUIPMENT 
REQUEST. 

REQ, ILLEGAL FILE NAME. 
RFL ARG. ERROR. 

ROLLIN FILE BAD. 

RPL ARG. ERROR. 

TIME LIMIT. 

TOO MANY ARGUMENTS. 


The system monitor has set the Operator Drop error 
flag. 

The first address specified in calling PBC is greater 
than the terminal address. 

The terminal address (second parameter) is outside the 
user field length while in a call to the Punch Binary 
Card (PBC) routine. 

The system monitor has detected an error in the last 
CPU request for PPU action. 

The system was unable to find the specified program 
in any of the system tables. 

The program does not reside on a mass storage device. 


The program does not fit in the storage area available. 

The fifth character of the file name, called by the Read 
Binary Record routine, is greater than seven. 

The requested record length is greater than or equal 
to the field length minus five (buffer parameter area) 

The length of the record is greater than the job length. 

Check the syntax for the REQUEST control card in 
Section 3. 

Control card bears a request for a non'-existent type 
of equipment. 

File name required to process REQUEST card is not 
left-justified alphanumeric characters with zero fill. 

The quantity of central memory requested exceeds that 
available, or the reference address is beyond the 
terminal address for the user's job. 

The system has encountered an error in the format 
of the job file while rolling in the job. 


The package entered into the resident peripheral 
library is greater than or equal to the area in central 
memory allotted for it. 

The job has exceeded the requested time limit. KRONOS 
aborts the job. 

The number of arguments on the control statement is 
greater than the number allowed by the program. 
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Message 


Explanation 


TRACK LIMIT. 
UNIDENTIFIED PROGRAM. 

WBR ARG. ERROR. 


The system monitor has set the Track Limit error flag. 

A program was not a PPU, a SCOPE, nor a Chippewa 
program. 

The fifth character of the file name is greater than 
seven. 


XXX TOO LONG. 

XXX NOT IN PP LIB. 

814 XX PARITY ERROR 
Tyyy Szzzz. 

854 XX PARITY ERROR 
Cyyy Szzz. 


The PPU package xxx exceeds 1,314 central memory 
words (the maximum PPU package size in length). 

KRONOS has assigned program xxx to a PPU for execu¬ 
tion, but program xxx is not in the system library. 
Typically, this happens when the user puts garbage in 
location RA+1. 

An 814xx (each half of the 814 is considered as one 
device) has detected an unrecoverable parity error at 
sector zzzz of track yyy. 

A 3234/853/854 driver has detected an unrecoverable 
parity error at sector zzz of cylinder yyy. 
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CONTROL CARDS 


E 


Control Card 

Function 

ACCOUNT, xxxxxxx. 

Specifies the user’s account number 

APPEND, Ifn., .... Ifn . 
ACCOUNT = xxxxxxx. 

Appends information to an existing permanent 
file 

ASSIGN (nn, Ifn, x) 

Assigns peripheral equipment 

BKSP (filej^, n) 

Backspaces n logical records 

CATALOG (filea, num, fileb) 

Makes a catalog for filea 

CAT LIST. or 

CAT LIST, F. or 

CAT LIST, xxxxxxx. 

Lists a catalog of the permanent files 

COMMON (Ifn) 

Creates or attaches a COMMON file 

COMMENT, comments 

Enters the dayfile message "comments" 

COMPASS (pj^, P 2 , . . ., 

Pn^ 

Calls COMPASS assembler 

COPY (file^, fileg) 

Copies to an empty file 

COPYBF (filei, file 2 , n) 

Copies n binary files 

COPYBR (filej^, file 2 , n) 

Copies n binary records 

COPYCF (file^, fileg, n) 

Copies n BCD files 

COPYCR (filei, fileg, n) 

Copies n BCD records 

COPYSBF (filej^, fileg, n) 

Copies n shifted binary files 

COPYX (file]^, file 2 . term, 
bksp) 

Copies binary records to terminator and 
backspaces 

DMP (fwa, Iwa) or 

DMP (Iwa) or 

DMP. 

Dumps storage 

DOCEXT (sfile, ^file) 

Calls the DOCEXT program which extracts the 
external documentation 

EXECUTE (name, p^ 

P2.Pn^ 

Executes starting at entry point "name" 

EXIT. 

Control cards to obey in case of error follow 
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Control Card 

Function 

GET, Ifn^ = pfn]_, . . ,, Ifn = pfn^, 
ACCOUNT = xxxxxxx. 

Retrieves a file from permanent storage 

LBC, addr. or 

LBC. 

Loads binary corrections 

LIBEDIT (pj^, P2, ...,Pn) 

Calls the LIBEDIT program 

LIBGEN (library, name, input) 

Generates a user library file 

LOAD (Ifn^) or (Ifn^, lfn 2 , . . ., 

Ifnn) 

Loads Ifni, satisfies references from lfn2 - 

Ifn^ 

LOC (fwa, Iwa) or 

LOC Qwa) or 

LOC. 

Loads octal corrections 

LOCK (Ifrij^, 

Sets the write lockout for file Ifn^^ 

MACE. 

Clears the SCOPE bit for loading a file 

MAP. 

Sets Map flag 

MAP{P) 

Sets Partial Map flag 

MODE (n) 

Sets error mode = n 

MODIFY (p^, P2, P^) 

Calls MODIFY 

NOGO. 

Finish loading process, do not execute 

NOMAP. 

Clears Map flag 

NOREDUCE. 

Sets No Reduce FL flag 

OFFSW (np . . . ,n^) 

Clears pseudo-sense switches 

ONSW (n^, . . ., n^) 

1 Sets pseudo-sense switches 

OVERLAY (Ifn, a, b, Cnnnnnn) 

Initiates an overlay for file Ifn 

PBC (fwa, Iwa) or 

PBC (Iwa) or 

PBC. 

Punches binary cards 

PERMIT, pfn, MODE-y, 
accnum^, . . ., accnum^. 

Grants permanent file access to other users 

PURGE, pfn^, ..., pfn^, 

ACCOUNT = xxxxxxx. 

Purges a permanent file 

RBR, n. 

Reads n binary records 

REDUCEFL. 

Clears No Reduce FL flag 
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Control Card 

Function 

RELEASE (Ifn) 

Changes status of a file from COMMON to 
LOCAL 

REPLACE. Ifni = pfnj, .... 
lfn„ = Pfnn' 

ACCOUNT = xxxxxxx. 

Substitutes a new file for an old permanent 
file 

REQUEST (Ifn, x) 

Requests an operator to assign equipment 

RESERVE (Ifn) 

Changes status of a file to COMMON 

RETURN (filei. fileo, .... 
filen) 

Returns files to the system 

REWIND (filei. fileo, .... 
men) 

Rewinds files 

RFL, nfl. 

Changes the field length 

ROLLOUT. 

Rolls out user's job 

RUN (cm, fl, bl, if, of, rf, 

Ic, as, cs) 

Calls FORTRAN compiler 

SATISFY (Ifn., Ifn^, .... 
lfn„) 

Satisfies external references from Ifn^ 

SAVE, lfn-| = pfn-j, . . . , 

= Pfnn- 

Retains files in the permanent file system 

SCOPE. 

Sets SCOPE bit for loading a file 

SETID (Ifni = ai, .... 

Ifiin = ajj) 

Assigns area code for file Ifn^j^ 

SETPR (p) 

Sets priority level 

SETTL (t) 

Sets time limit 

SKI PEI (filej) 

Skips to End-of-Information 

SKIPF (filei, n) 

Skips n files forward 

SKIPFB (filei, 

Skips n files backward 

SKIPR (filei. n) 

Skips n records forward 

SYSREF (pi, P 2 , .... Pj^) 

Generates a list of system symbols 

UNLOAD (filei, file 2 . .... file^) 

Unloads and rewinds files 

UPMOD (pp P 2 , . . ., Pjj) 

Converts program libraries maintained by 
UPDATE to libraries that can be maintained 
by MODIFY 

VERIFY (filej^, file2, Pi.P2« 

.... P„) 

Compares data in two files 
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Control Card 

Function 

VFYLIB (old, new, output, r) 

Compares old library file with a new one 

WBR, n, rl. 

Writes n binary records 

WRITE F (file^, n) 

Writes n file marks on a file 

WRITER (file, n) 

Writes n empty records on a file 
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INDEX 


ABORT Function, 4-8, 4-11 
ACCOUNT Card, 3-2 
Action Requests, File, 4-17 
Action Requests, Job, 4-8 
Address Mode, 1-7 
Allocation, Memory, 5-4 
APPEND Card, 3-17 
Area, Control Point, 1-3 
ASSIGN Card, 3-13 
ASSIGN Function, 4-17, 4-18 

Backspace Logical Records 
(BKSP), 7-10 

BCD Format Magnetic Tape, 
Unblocked External, 1-10 
BCD Format Magnetic Tape, 
Blocked External, 1-10 
Binary Card, C-1 
Binary File (Random), 4-7 
Binary File (Sequential), 4-7 
Binary Punched Cards, 1-8 
(BKSP) Backspace Logical 
Records, 7-10 
BKSP Function, 4-17, 4-30 
BKSPRU Function, 4-17, 4-30 
Blocked External BCD Format 
Magnetic Tape, 1-10 
Buffer, Circular, 4-1 

Call Card, Program, 3-6 
Card, ACCOUNT, 3-2 
Card, APPEND, 3-17 
Card, ASSIGN, 3-13 
Card, Binary, C-1 
Card, Binary Punched, 1-8 
Card, CATLIST, 3-17 
Card, COMMENT, 3-3 
Card, COMMON, 3-14 
Card, COMPASS, 3-8 
Card, Control, E-1 
Card, EXECUTE, 3-6 
Card, EXIT, 3-3 
Card, Format, C-1 
Card, FORTRAN, 3-7 
Card, GET, 3-16 
Card, Job, 3-1 
Card, Job Control, 3-1 
Card, LOAD, 3-5 


Card, LOCK, 3-15 
Card, MACE, 3-15 
Card, MAP, 3-4 
Card, MODE, 3-3 
Card, MODIFY, 3-9 
Card, NOGO, 3-11 
Card, NOMAP, 3-4 
Card, NOREDUCE, 3-4 
Card, OFFSW, 3-2 
Card, ONSW, 3-2 
Card, Overlay, 5-3 
Card, Partial Map, 3-4 
Card, PERMIT, 3-17 
Card, Program Call, 3-6 
Card, PURGE, 3-16 
Card, REDUCEFL, 3-4 
Card, RELEASE, 3-14 
Card, REPLACE, 3-16 
Card, REQUEST, 3-12 
Card, ROLLOUT, 3-4 
Card, SATISFY, 3-6 
Card, SAVE, 3-15 
Card, SCOPE, 3-15 
Card, SETID, 3-14 
Card, SETPR, 3-5 
Card, SETTL, 3-5 
Card Translation, Control, 2-2 
Card, UNLOCK, 3-15 
Cards, Coded, C-2 
Cards, Coded Punched, 1-7 
Cards, Control, 3-1 
Cards, File Management 
Control, 3-11 

Cards, Permanent File Control, 
3-15 

Cards, Program Execution 
Control, 3-5 
Carriage Control, 1-8 
(CATALOG) Catalog File Set, 7-3 
Catalog File Set (CATALOG), 7-3 
CATLIST Card, 3-17 
Central Memory, 1-3 
Central Processor Unit, 1-2 
Character Set, F-1 
Circular Buffer, 4-1 
CLOCK Function, 4-8, 4-12 
Coded Cards, C-2 
Coded File (Random), 4-7 


Coded File (Sequential), 4-7 
Coded Punched Cards, 1-7 
Codes, Input/Output, A-1 
COMMENT Card, 3-3 
COMMON Card, 3-14 
COMMON Function, 4-17, 4-19 
Communication, Program/System, 
4-1 

Communication Subroutines, User/ 
System, 4-8 

Compare Library Files (VFYLIB), 
7-4 

Compare Records, (VERIFY), 7-4 
COMPASS Card, 3-8 
Compass Decks, 6-2 
CONSOLE Function, 4-8, 4-13 
Control Card, E-1 
Control Card Translation, 2-2 
Control Cards, 3-1 
Control Cards, File Management, 
3-11 

Control Cards, Job, 3-1 
Control Cards, Permanent File, 
3-15 

Control Cards, Program 
Execution, 3-5 
Control, Carriage, 1-8 
Control Point Area, 1-3 
Control Point Number, 1-4 
Control Points, 1-3 
Conversion, 1-8 

Convert Update Library to Modify 
Library (UPMOD), 7-3 
(COPYBF) Copy Binary File, 7-6 
Copy Binary File (COPYBF), 7-6 
Copy Binary Record (COPYBR), 

7-6 

(COPYBR) Copy Binary Record, 

7-6 

Copy Coded File (COPYCF), 7-6 
Copy Coded Record (COPYCR), 

7-7 

(COPY) Copy Through Empty 
File, 7-5 

(COPYCF), Copy Coded File, 7-6 
(COPYCR), Copy Coded Record, 

7-7 

Copy Routines. 7-5 
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(COPYSBF), Copy Shifted Binary 
File, 7-7 

Copy Shifted Binary File 
(COPYSBF), 7-7 
Copy Through Empty File 
(COPY), 7-5 

Copy to Terminator (COPYX), 7-8 
(COPYX), Copy to Terminator, 7-8 
Creation Macros, FET, 4-7 

Data Formats, 1-6 
Data Printed, 1-8 
Data Requests, Transfer, 4-22 
DATE Function, 4-8, 4-12 
Deck Structures, 6-1 
Decks, Compass, 6-2 
Decks, FORTRAN, 6-4 
Decks, Overlay, 6-5 
Description, System, 1-1 
Diagnostic Messages, Error, D-1 
Directives, Loader, 5-3 
(DMP), Dump Storage, 7-13 
(DOCEXT), Extract External 
Documentation, 7-5 
Dump Storage (DMP), 7-13 

Edit User Library File (LIBEDIT), 
7-2 

ENDRUN Function, 4-8, 4-10 
(ENTR) Entry Point Table, B-2 
Entry Point Table (ENTR), B-2 
Environment Table, File, 4-3 
EREXIT Function, 4-8, 4-14 
Error Diagnostic Messages, D-1 
EVICT Function, 4-17, 4-18 
EXECUTE Card, 3-6 
Execution Control Cards, Program, 
3-5 

Execution, Job, 2-1 
EXIT Card, 3-3 
EXPORT/IMPORT, 1-3 
External BCD Format Magnetic 
Tape, Blocked, 1-10 
External BCD Format Magnetic 
Tape, Unblocked, 1-10 
Extract External Documentation 
(DOCEXT), 7-5 

FET, see File Environment Table 
FET Creation Macros, 4-7 
FILE, 1-4 

File Action Requests, 4-17 
File Control Cards, Permanent, 
3-15 

File Environment Table, 4-3 


File, Input, 1-5 

File Management Control Cards, 
3-11 

File Manipulation Routines, 7-8 
File Name, 1-4 
File, Output, 1-5 
File, P8, 1-5 
File, Punch, 1-5 
File, Punchb, 1-5 
File (Random), Binary, 4-7 
File (Random), Coded, 4-7 
File Requests, Position, 4-29 
File, REWIND, 7-8 
File (Sequential), Binary, 4-7 
File (Sequential), Coded, 4-7 
File, UNLOAD, 7-8 
Files, Permanent, 1-10 
Files, RETURN, 7-10 
Fill Table, B-3 
FIRST, Location, 4-1 
Format, Card, C-1 
Format Magnetic Tape, Blocked 
External BCD, 1-10 
Format Magnetic Tape, Standard, 
1-9 

Format Magnetic Tape, Unblocked 
External BCD, 1-10 
Format, Overlay, 5-4 
Formats, Data, 1-6 
Formats, Relocatable Subroutines, 
B-1 

FORTRAN Card, 3-7 
FORTRAN Decks, 6-4 
Function, ABORT, 4-8, 4-11 
Function, ASSIGN, 4-17, 4-18 
Function, BKSP, 4-17, 4-30 
Function, BKSPRU, 41-7, 4-30 
Function, CLOCK, 4-8, 4-12 
Function, COMMON, 4-17, 4-19 
Function, CONSOLE, 4-8, 4-13 
Function, DATE, 4-8, 4-12 
Function, ENDRUN, 4-8, 4-10 
Function, EREXIT, 4-8, 4-14 
Function, EVICT, 4-17, 4-18 
Function, LOCK, 4-17, 4-19 
Function, MEMORY, 4-8, 4-9 
Function, MESSAGE, 4-8, 4-10 
Function, MODE, 4-8, 4-15 
Function, OFFSW, 4-8, 4-14 
Function, ONSW, 4-8, 4-14 
Function, OVERLAY, 4-8, 4-15 
Function, READ, 4-17, 4-22 
Function, READC, 4-17, 4-23 
Function, READH, 4-17, 4-24 
Function, READS, 4-17, 4-24 


Function, READW, 4-17, 4-25 
Function, RECALL, 4-8, 4-9 
Function, RELEASE, 4-17, 4-19 
Function, RENAME, 4-17, 4-20 
Function, REQUEST, 4-17, 4-20 
Function, RETURN, 4-17, 4-18 
Function, REWIND, 4-17, 4-32 
Function, ROLLOUT, 4-8, 4-15 
Function, RPHR, 4-17, 4-23 
Function, RTIME, 4-8, 4-11 
Function, SETID, 4-17, 4-21 
Function, SET PR, 4-8, 4-16 
Function, SETTL, 4-8, 4-17 
Function, SKIPB, 4-17, 4-31 
Function, SKIPEI, 4-17, 4-30 
Function, SKIFF, 4-17, 4-29 
Function, SKIPFB, 4-17, 4-31 
Function, SKIPFF, 4-17, 4-29 
Function, STATUS, 4-17, 4-21 
Function, SYSTEM, 4-8, 4-13 
Function, TIME, 4-8, 4-11 
Function, UNLOAD, 4-17, 4-32 
Function, UNLOCK, 4-17, 4-22 
Function, WPHR, 4-17, 4-27 
Function, WRITE, 4-17, 4-25 
Function, WRITEC, 4-17, 4-27 
Function, WRITEF, 4-17, 4-26 
Function, WRITER, 4-17, 4-27 
Function, WRITER, 4-17, 4-26 
Function, WRITES, 4-17, 4-28 
Function, WRITEW, 4-17, 4-28 

Generate System Symbol Cross 
Reference (SYSREF), 7-5 
Generate User Library File 
(LIBGEN), 7-1 
GET Card, 3-16 

Hardware/Software Integration, 1-1 

Identification Word, B-1 

IN Location, 4-3 

Index Mode, 1-7 

Information System, 4-4 

Information, User, 4-4 

Input File, 1-5 

Input, Job, 2-1 

Input/Output Codes, A-1 

Input/Output Routines, 7-10 

Integration, Hardware/Software, 

1-1 

Introduction, 1-1 

Job Action Request, 4-8 
Job Card, 3-1 


Index-2 
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Job Execution, 2-1 
Job Input, 2-1 
Job Output, 2-2 
Job Processing, 2-1 

(LBC), Load Binary Corrections, 
7-10 

(LIBEDIT), Edit User Library 
File, 7-2 

(LIBGEN), Generate User Library 
File, 7-1 

Library Routines, 7-1 

LIMIT, Location, 4-2 

Link Table, B-4 

Load Binary Corrections (LBC), 

7-10 

LOAD Card, 3-5 

Load Octal Corrections (LOC), 7-11 

Loader, 5-1 

Loader Directives, 5-3 

Loader Operation, 5-1 

(LOC), Load Octal Corrections, 7-11 

Location, FIRST, 4-1 

Location, IN, 4-3 

Location, LIMIT, 4-2 

Location, OUT, 4-2 

LOCK Card, 3-15 

LOCK Function, 4-17, 4-19 

Logical Records, 1-5 

MACE Card, 3-15 
Macros, FET Creation, 4-7 
Magnetic Tape, Blocked External 
BCD Format, 1-10 
Magnetic Tape, Standard Format, 

1-9 

Magnetic Tape, Unblocked External 
BCD Format, 1-10 
Management Control Cards, File, 
3-11 

Manipulation Routines, File, 7-8 

MAP Card, 3-4 

Map Card, Partial, 3-4 

Map, Memory, 5-6 

Mass Storage, 1-6 

Memory Allocation, 5-4 

Memory, Central, 1-3 

MEMORY Function, 4-8, 4-9 

Memory Map, 5-6 

MESSAGE Function, 4-8, 4-10 

Message, Error Diagnostics, D-1 

Mode, Address, 1-7 

MODE Card, 3-3 

MODE Function, 4-8, 4-15 

Mode, Index, 1-7 


MODIFY Card, 3-9 
Multiprogramming, 1-3 

Name, File, 1-4 
NOGO Card, 3-11 
NOMAP Card, 3-4 
NOREDUCE Card, 3-4 
Number, Control Point, 1-4 

OFFSW Card, 3-2 

OFFSW Function, 4-8, 4-14 

ONSW Card, 3-2 

ONSW Function, 4-8, 4-14 

Operation, Loader, 5-1 

OUT Location, 4-2 

Output File, 1 -5 

Output Job, 2-2 

Overlay Card, 5-3 

Overlay Decks, 5-4 

Overlay Format, 5-4 

OVERLAY Function, 4-8, 4-15 

Overlays, 5-2 

P8 File, 1-5 
Partial Map Card, 3-4 
(PBC), Punch Binary Cards, 7-11 
Peripheral Processor Unit, 1-2 
Permanent File Control Cards, 3-15 
Permanent Files, 1-10 
PERMIT Card, 3-17 
(PIDL), Program Identification and 
Length Table, B-2 
Point Area, Control, 1-3 
Point Number, Control, 1-4 
Points, Control, 1-3 
Position File Requests, 4-29 
Printed Data, 1-8 
Processing, Job, 2-1 
Processor Unit, Central, 1-2 
Processor Unit, Peripheral, 1-2 
Program Call Card, 3-6 
Program Execution Control 
Cards, 3-5 

Program Identification and Length 
Table (PIDL), B-2 
Program/System Communication, 
4-1 

Program, Utility, 7-1 

Punch Binary Cards (PBC), 7-11 

Punch File, 1-5 

Punchb File, 1-5 

Punched Cards, Binary, 1-8 

Punched Cards, Coded, 1-7 

PURGE Card, 3-16 


(Random), Binary File, 4-7 
(Random), Coded File, 4-7 
(RBR), Read Binary Record, 7-11 
Read Binary Record (RBR), 7-11 
READ Function, 4-17, 4-22 
READC Function, 4-17, 4-23 
READH Function, 4-17, 4-24 
READS Function, 4-17, 4-24 
READW Function, 4-17, 4-25 
RECALL Function, 4-8, 4-9 
Records, Logical, 1-5 
REDUCEFL Card, 3-4 
RELEASE Card, 3-14 
RELEASE Function, 4-17, 4-19 
Relocatable Subroutine Formats, B-1 
RENAME Function, 4-17, 4-20 
REPLACE Card, 3-16 
Replication Table, B-5 
REQUEST Card, 3-12 
Request Field Length (RFL), 7-13 
REQUEST Function, 4-17, 4-20 
Requests, File Action, 4-17 
Requests, Job Action, 4-8 
Requests, Position File, 4-29 
Requests, Transfer Data, 4-22 
RETURN Files, 7-10 
RETURN Function, 4-17, 4-18 
REWIND File, 7-8 
REWIND Function, 4-17, 4-32 
(RFL), Request Field Length, 7-13 
ROLLOUT Card, 3-4 
ROLLOUT Function, 4-8, 4-15 
Routines, Copy, 7-5 
Routines, File Manipulation, 7-8 
Routines, Input/Output, 7-10 
Routines, Library, 7-1 
RPHR Function, 4-17, 4-23 
RTIME Function, 4-8, 4-11 

SATISFY Card, 3-6 
SAVE Card, 3-15 
SCOPE Card, 3-15 
(Sequential), Binary File, 4-7 
(Sequential), Coded File, 4-7 
Set, Character, F-1 
SETID Card, 3-14 
SETID Function, 4-17, 4-21 
SETPR Card, 3-5 
SETPR Function, 4-8, 4-16 
SETTL Card, 3-5 
SETTL Function, 4-8, 4-17 
Skip File Backward (SKIPFB), 7-9 
Skip File Forward (SKIPF), 7-9 
Skip Record Forward (SKIPR), 7-9 
Skip to End-of-Information 
(SKIPEI), 7-9 
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SKIPB Function, 4-17 
SKIPEI Function, 4-17, 4-30 
(SKIPEI) Skip to End-of- 
Information, 7-9 
SKIPF Function, 4-17, 4-29 
(SKIPF) Skip File Forward, 7-9 
SKIPFB Function, 4-17, 4-31 
(SKIPFB) Skip File Backward, 7-9 
SKIPFF Function, 4-17, 4-29 
(SKIPR) Skip Record Forward, 7-9 
Standard Format Magnetic Tape, 1-9 
STATUS Function, 4-17, 4-21 
Storage, Mass, 1-6 
Structure, Deck, 6-1 
Subroutine Formats, 

Relocatable, B-1 
Subroutines, User System 
Communication, 4-8 
(SYSREF), Generate System Symbol 
Cross Reference, 7-5 
System, 1-1, 5-4 
System Description, 1-1 
SYSTEM Function, 4-8, 4-13 
System Information, 4-4 

Table, (ENTR), Entry Point, B-2 
Table, File Environment, 4-3 
Table, Fill, B-3 


Table, (PIDL), Program 

Identification and Length, B-2 
Table, Replication, B-5 
Table, Transfer, B-5 
Tables, Text, B-3 
Tape, Blocked External BCD 
Format Magnetic, 1-10 
Tape, Standard Format 
Magnetic, 1-9 

Tape, Unblocked External BCD 
Format Magnetic, 1-10 
TELEX, 1-3 
Text Tables, B-3 
TIME Function, 4-8, 4-11 
Transfer Data Requests, 4-22 
Transfer Table, B-5 
Translation, Control Card, 2-2 

Unblocked External BCD Format 
Magnetic Tape, 1-10 
Unit, Central Processor, 1-2 
Unit, Peripheral Processor, 1-2 
UNLOAD File, 7-8 
UNLOAD Function, 4-17, 4-32 
UNLOCK Card, 3-15 
UNLOCK Function, 4-17, 4-22 
(UPMOD) Convert Update Library 
to Modify Library, 7-3 


User, 5-6 

User Information, 4-4 
User/System Communication 
Subroutines, 4-8 
Utility Programs, 7-1 

(VERIFY), Compare Records, 7-4 
(VFYLIB), Compare Library 
Files, 7-4 

(WBR), Write Binary Record, 7-12 
Word, Identification, B-1 
WPHR Function, 4-17, 4-27 
Write Binary Record (WBR), 7-12 
Write Empty Records (WRITER), 
7-12 

Write File Marks (WRITEF), 7-12 
WRITE Function, 4-17, 4-23 
WRITEC Function, 4-17, 4-27 
WRITEF Function, 4-17, 4-26 
(WRITEF) Write File Marks, 7-12 
WRITER Function, 4-17, 4-27 
WRITER Function, 4-17, 4-26 
(WRITER), Write Empty Records, 
7-12 

WRITES Function, 4-17, 4-28 
WRITEW Function, 4-17, 4-28 
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